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SINCLAIR DEVELOPS A 'NEW' 8K ROM: 


The originad 8K ROM issued by Sinclair Research in March 198] has 
unfortunately been found to contain several errors. The major 
problem is errors in calculations: 


e.g. 
PRINT 0.25 ** 2 gives 3.1423844, which is rather a long way 
from the correct answer. 


As well, the line POKE 16437, 255 has to be added for safety 
after every use of the PAUSE command to prevent the ‘white-out' 
effect. 


These failures in the program of the 8K ROM have resulted in the 
issue of a ‘new’ 8K ROM by Sinclair Research. 


This new ROM can be identified by obtaining the following results: 
- PRINT 0.25 ** 2 gives the correct answer 0.0625 
- PRINT PEEK 54 gives 136 


(Both tests are necessary as there are just a few ZX 81s that 
contain a hardware add-on to make them count properly, but they do 
not contain the 'new' ROM.) 


The differences between the 'new' and the ‘old' ROMs are: 


1) The workspace is cleared in the INPUT command routine 
(a house-keeping error) 

77) FRAMES-high, 16437, is loaded with 255 on every return 
from PAUSE. (a very good idea.) 

i171) A change has been made in the VARIABLE routine at 
1O2F Hex. (the reason for this is not known as yet) 

iv) And most importantly the three troublesome '‘extra'bytes 
at 1733 - 1735 Hex. that lead to the arithmetic error 
are simply deleted. 


Although it is as yet unconfirmed by Sinclair, it would appear that 
the hardware add-on that corrects the arithmetic on some of 

the ‘old' 8K ROMs works by nullifying the effect of the ‘three 
bytes'. Probably when the location 1735 is addressed the 
instruction fetched is ‘LD H,A' but the instruction passed to the 
Z80 is 'DAA'. 


Readers of this book that are using machines fitted with the ‘new’ 
ROM will have to bear the following points in mind: 


The addresses of the routines between 0000 and OEE9 are unchanged. 
Between OF20 and 1022 they are moved up by 3 bytes. 

Between 1046 and 1716 they are moved up by 4 bytes. 

Between 1737 and 1DE1] they are moved up by 1 byte. 

The character generator remains at JEQ0O. 


The changes mean that in: 


Chapter 4: the references to change are 
the CLEAR command routine is at 149A 
the ‘assignment of a string variable’ routine is at 13C8 
the FAST command routine is at OF23 
the SLOW command routine is at OF2B. 


Chapter 6: the references to change are 
Floating point handling routine - 158A 
The function table - 1915 
The floating point calculator - 199D 
DIM - 1409 CLEAR - 149A PAUSE - OF32 
SLOW - OF2B FAST - OF23 


Chapter 7: the change to make is 
As SLOW is now at OF2B the value to be entered in location 
16534 1s changed to 43 decimal. Remember the checksum 
will go up by 3. 
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Preface 


in the spring of 1980 Science of Cambridge (now Sinclair Research) 
launched the ZX-80. It was the first of a new type of microcomputer for 
the hobbyist. At last there was a very cheap and reliable machine that 
together with an ordinary T.V. set and a cassette player formed a power- 
ful home microcomputer system. 

Although the ZX-80 was highly successful it was possible for Sinclair 
Research to put a much improved version on the market by the spring of 
1981. This second machine is called the ZX-81. 

The ZX-81 is supplied with a 8K ROM that contains the operating 
system program and a floating-point BASIC interpreter. The BASIC is 
very easy to use and is quite fast enough for most simple programming 
tasks. The added feature of ‘syntax checking’ is really quite a remarkable 
extra to be found on such a small machine. 

However once BASIC has been mastered the attraction of machine 
code programming offers to the programmer, the possibility of producing 
programs that RUN at great speed, and can be as complicated, for their 
size, aS any programs written for larger machines. 

The main themes of this book are to develop an understanding of the 
Z80 machine code language and to discuss the actual workings of the 8K 
monitor program. 

It is hoped that readers with only a knowledge of BASIC, will gain the 
ability to write short machine code programs for themselves and thereby 
derive even greater pleasure from their ZX-81. 
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1. Introduction 


1.1 This book can be divided into two major parts. 


The first part, chapters 1-4, discuss the Z80 microprocessor and its 
machine code instructions. 

_ The second part, chapters 5-7, deals with actual machine code prog- 
rams. Chapter 5 containing programs that illustrate the different types of 
machine code instructions in the Z80 instruction set. Chapter 6 dis- 
cusses the 8K monitor program and chapter 7 gives some suggestions 
on how to go about writing a machine code program. | 

Throughout the book there are many references to the 8K monitor 
program. This program being chosen as an example program because it 
is the only machine code program that is supplied with the standard 
ZX-81. 

It is assumed that the readers of this book will already have a fairly 
good understanding of the BASIC language as used in the ZX-81. New 
terms will be explained as they occur, drawing only on that knowledge of 
the BASIC language. 


1.2 The standard ZX-81 microcomputer system: 


The standard system comprises: 

1. The ZX-81 mainboard with 1-16K RAM (or more) 

2. The keyboard, (integral with the mainboard unless otherwise 
adapted). 

3. The T.V. receiver. 

4. The cassette player. 
This standard system can be shown diagrammatically as: 


T.V. RECEIVER MAINBOARD 


Display 
output SINCLAIR 














Keyboard 
input 





CASSETTE 
PLAYER 


KEYBOARD 


Diagram 1. The standard ZX-81 microcomputer system 


rs) 


Before the power supply is connected to the mainboard, it is really 
quite obvious that no work can be performed by the system. However 
once the power is connected the Z80 microprocessor starts working — 
executing instructions sequentially — at its operating speed of 3.25 mhz. 
A simple instruction will take 1.23 microseconds and the longest instruc- 
tions no longer than 7.46 microseconds. The microprocessor then con- 
tinues to execute between 141,00 and 812,500 machine code instruc- 
tions each and every second until the power is turned off. 

This book aims to develop an understanding for the reader of just what 
the computer system is doing all the time, and why even very simple 
tasks sometimes take a lot longer than ‘one eight hundred thousandth’ of 
a second to be completed. 

This book also introduces the reader to the subject of monitor prog- 
rams but let it suffice for the moment to say that it is the monitor program 
that is followed by the Z80, unless the BASIC USR command is ean 
used, and it directs the ZX-81 to; 

“Produce” a screen display. 

“Scan” the keyboard to detect keystrokes. 

“Provide” a system for the LOADing and SAVEing of programs on 
cassette tape. 

“Give” the user the BASIC language. 


2. The Z80 Microprocessor 


2.1 The Z80 in outline. 


The ZX-81 microcomputer has as its largest and most important ‘silicon’ 
chip a Z80 microprocessor. The Z80 is so called because it was de- 
veloped by Zilog, inc. of California, U.S.A. This company expanded and 
improved an earlier microprocessor, the INTEL 8080. The figure ‘8’ in the 
name also implies that it is an eight bit microprocessor. 

A microprocessor is a ‘silicon’ chip, and incommon with other ‘chips’, it 
has input lines (= wires) that carry electrical impulses into the chip, 
output lines that carry impulses away, and power and ground 
connections. 

But a microprocesor is a very specialised chip, that as the name 
implies has been designed to perform specifically as a small ‘processor 
or computer. 

Internally it is amazingly complicated, but fortunately the internal 
structure can be divided into five functional parts. These are the Control 
Unit, the Instruction Register, the Program Counter, the 24 User- 
registers and the Arithmetic-logic unit. 

This simplified view of the internal structure of the Z80 is shown 
diagrammatically in diagram 2. 
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Diagram 2. The Z80 microprocessor in outline. 
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A Z80 microprocessor only works as a computer because it is a 
machine capable of following a ‘stored program’. This program is re- 
quired to be in the form of a sequence of machine code language 
instructions, that the Z80 can execute, together with any data that is 
required. The whole of this program must be present in memory that can 
be accessed by the Z80. 

The 8K monitor program is such a program, and by being supplied ina 
ROM (read only memory) it is permanently present in memory. indeed 
the standard ZX-81 has the monitor program so placed in memory that 
when the power to the Z80 is turned on, it is this program that is followed 
immediately. 


2.2 The Data and Address buses 


The Z80 microprocessor cannot work in isolation and it must therefore 
have connections to the other parts of the system. These connections 
are of three types, viz. the Control lines, the Data lines and the Address 
lines. 

The Control lines are single tracked (= 1 wire), whereas the Data lines 
are usually collected together as an 8 track DATA BUS and the Address 
lines as a 16 track ADDRESS BUS. 

The Control lines will be discussed in the next section. 

The Data bus is used to carry 8 binary digits at a time, in parallel. The 
level of the voltage on a particular line signifying whether the line is 
carrying a binary 0 or a binary 1. Each binary digit is usually called a ‘bit’ 
and a collection of 8 bits held together for a particular purpose is called a 
‘pyte’. The Data bus is therefore said to be able to carry ‘1 byte’ of data at 
a time. The term ‘byte’ is commonly used to describe a ‘place’ where 8 
bits of data would fit, rather than to an actual ‘byte’ of data. 

The Address bus has 16 tracks and is therefore described as being ‘2 
bytes’ in width. 

It is a fundamental principle of the Z80 that data is held as a byte of 8 
binary digits and an address is held always as 2 bytes, that is 16 binary 
digits. 

The Data bus is used to carry bytes of data to and from the Z80 and it 
therefore physically links the Z80 to the RAM chips (random access 
memory) and the ROM. The Data bus is also joined to the circuitry of the 
keyboard, the T.V. display and the cassette player interfaces. 

The Address bus also links the Z80 to the RAM chips and the ROM, 
and in the ZX81 there are certain links to the keys of the keyboard. 

Diagram 3 shows the Z80 and the main bus system. 
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Diagram 3. The Address bus, the Data bus and the Z80. 


The Address bus is used to hold the addresses of the location in the 
memory of the Z80, whether it be RAM, ROM or something else. As the 
Address bus can hold a 16 bit binary number it follows that the range of 
addresses that can be present on the Address bus can range from; 

binary 0000 0000 0000 0000 — 11114 1111 1111 1111 which has the 
decimal equivalent of; 

0 — 65535 (location 0 being the first location) 

When the Z80 is running, bytes of data are continually being READ 
from memory and WRITTEN into the memory. 

In order to perform a READ operation, the specific address of the 
required location in memory must first be placed on the Address bus, 
then the byte of data in that location can be copied and the copy passed 
along the Data bus to the Z80. 

In order to WRITE a byte of data into the memory, the required address 
must first be placed on the Address bus, then the Z80 puts the byte of 
data onto the Data bus and the memory chip subsequently collects the 
byte of data. 

The five functional parts of the internal structure of the Z80 will now be 
discussed in turn. 


2.3 The Control Unit. 

The Control unit of the Z80 can be likened, in a simplistic manner, to the 
‘manager of a production line’. It is therefore the responsibility of the 
Control unit, the manager, to arrange that materials (data) are brought 
into the Z80, that finished products (also data) are sent out to the correct 
destination and to ensure that the ‘production’ is timed successfully. 

In the case of the Z80 there are a large number of different timing 
signals that are generated. Some of these signals are used only within 
the Z80 itself, with the rest being put out on the Control Lines. 

The Control Lines are those lines that carry ‘signals’ to and from the 
Z80. For example there is a control line called ‘READ’ that is used during 
the operation of reading data from outside the 280. 

It is important to understand that the Control Unit, like the production 
manager, is in no way responsible for deciding which work is to be done, 
only for actually doing the work. The Z80 has to follow the ‘program’ as 
written by the programmer and the production manager has to follow the 
‘program’ as set out by his company directors. 

A more detailed discussion on the Control Unit and the Control signals 
is beyond the scope of this book. 

2.4 The Instruction Register 


The term ‘Register’ is used to describe a single byte location within the 
Z80 itself. It therefore is an actual place where 8 bits of data can be held. 
In the Z80 there are a whole series of registers and the moving of bytes of 
data ‘into and out of’ registers is the most important single feature of 
machine code programming. 

The Instruction Register is a register within the Z80 that has the 
specific purpose of holding a copy of the instruction that is currently being 
executed. 

As was Said earlier, the Z80 microprocessor only works as a computer 
because it is a machine capable of following a stored program. | 

When the Z80 is following such a program, a copy of each instruction in 
turn will be placed in the Instruction Register prior to its being decoded 
and executed by the Z80. 


2.5 The Program Counter 


The Program Counter is not a single register but is a pair of registers 
within the Z80. it is used for the specific purposes of holding the address 
of the location in memory either of the current instruction that is being 
‘executed’, or of the next instruction to be ‘fetched’. 

When an instruction is to be ‘fetched’, the Control Unit arranges that a 
copy of the contents of the location that is addressed by the Program 
Counter, is loaded into the Instruction Register. It is also one of the jobs of 
the Control Unit to ensure that the value in the Program Counter is then 
changed so as to ‘point’ to the location of the next instruction. 


10 


The actions of the Program Counter are very similar to those of the 
BASIC interpreter’s ‘Line number of current statement variable. (16391 - 
2). This variable holds the line numbers of the ‘current statements’ as the 
interpreter goes through the lines of a BASIC program. 


2.6 The User-Registers. (Main registers) 


There are 24 User-Registers within the Z80. They have been termed 
‘User’ registers because they can be filled with specified bytes of data by 
the programmer. 

The names given to these 24 different registers are not at a first glance 
logically arranged. The reason for this state of affairs being that the Z80 is 
a microprocessor that has evolved from earlier, and less complicated, 
models. Certain of the names hark back to the earliest microprocessors 
that were ever made, whilst later names have been added in an ‘ad hoc’ 
fashion. Some names proving to be more appropriate, and informative, 
than others. 

All of the registers, strictly, are single byte registers but they are 
commonly used as register pairs. 

The following diagram shows the 24 User-registers of the Z80 dis- 
played as 12 register pairs, The ‘bit numbers’ are also shown. 


Main Set Alternate Set 


, 


, 
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76543210 76543210 76543210 76543210 


: 
; 
- 


76543210 76543210 76543210 76543210 


76543210 76543210 76543210 76543210 


76543210 76543210 76543210 76543210 


76543210 76543210 
Diagram 4. The 24 User-Registers of the Z80. 
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Each of these registers will now be discussed briefly: 
The A register: 

This register is the single most important register of the Z80. It is often 
called the ACCUMULATOR, a name that goes back to those models in 
which there was only one register that could be used to ‘accumulate’ a 
result. 

In the Z80 the A register is extensively used for arithmetic and logical 
operations, and indeed there are many operations that can only be 
performed using the A register. 

There is a great number of different ways in which a byte of data can be 
entered into the A register by the programmer and hence there are many 
machine code language instructions that involve the use of the A 
register. 


The F register: 

This is the FLAG REGISTER and it is often considered to be a 
collection of 8 bits rather than a true register. 

The concept of flags will be dealt with fully in chapter 4, but simply a 
flag is a ‘bit’ that is given the value 0 (RESET) or the value 1 (SET) 
depending on the result of the operation. 

The flag register does have 8 bits but the programmer is really only 
concerned with the ‘4 major flags’. These are called the Zero flag, the 
Sign flag, the Carry flag and the Parity/overflow flag. 

The ‘minor flags’ are used by the Control Unit and cannot directly be 
used by the programmer. 


The HL register pair: 

in early microprocessors the register that was used to hold addresses 
was a single byte ‘address register’, and was capable of addressing 256 
locations. However when 2-byte address registers were introduced, one 
of the registers was called the ‘high address register’ and the other the 
‘low address register’. A register pair is capable of addressing 65536 
locations. 

The ‘H’ and ‘L’ therefore derive their origins from the words ‘high’ and 
‘low’. It is also interesting to note that the ‘high’ register, being a later 
development has lead to the situation whereby an address, is always 
given as the ‘low’ byte followed by the ‘high’ byte. 

In the Z80 the HL register pair is just one of three register pairs that are 
used to hold addresses. However the HL register is the most important. 
The HL register pair can also be used to hold 16 bit numbers, rather than 
addresses, and there are a certain number of arithmetic operations that 
can be performed on these numbers. The registers of this pair can also 
be used as single byte registers. However there are relatively few opera- 
tions that can be performed on the H register, or the L register, as 
compared to the A register. 
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The BC and DE register pairs: 7 

These are the other register pairs that are predominantly used within 
the Z80 to hold addresses. It would appear that their names were simply 
derived because an ‘A’ register already existed. 

Once again the programmer may use the registers as single registers, 
and also there are certain instructions that use some of these registers as 
counters. 


The Alternate register set: 

The 280 is an interesting microprocessor in that it has an alternate 
register set for the A, F, H, L, B, C, D & E registers. These alterate 
registers are designated for A’, F’, H’, L’, B’, C’, D’ & E’ registers. 

There are two special instructions in the Z80 instruction set that allow 
for the contents of the alternate set of registers to be exchanged with the 
contents of the current main set of registers. Once the registers have 
been exchanged the Z80 will work with the ‘former alternate set’ believ- 
ing it to now be its ‘main set’. The ‘former main set’ will now be treated as 
an ‘alternate set’. 

The programmer may exchange the register sets, totally or in part, as 
often as he wishes in a particular program. 

The concept of there being alternate registers may sound to be very 
simple, but in practice it is far from being so. The problem is that the 
programmer has to make sure that he knows which set of registers is 
actually being used at a particular moment, as there are no machine 
code instructions that only work on one set of registers and not the other. 

Consequently there are many programmers that never use any of 
registers in the alternate set, and their programs are perfectly successful. 
However programs that take full advantage of the alternate set of re- 
gisters may run faster than programs that do not. | 

In many Z80 systems the use of the alternate set of registers is 
restricted, and indeed this is the case in the ZX-81 system running with 
the 8K monitor program. This means that a machine code program that is 
to ‘return’ to BASIC must not use some of the alternate registers, how- 
ever a Self-contained machine code program is quite free to use the full 
set of alternate registers. 


The IX and IY register pairs: 

These two register pairs are used to perform operations using ‘index- 
ing’. This is a facility which allows for entries in a list or table to be 
manipulated as long as the Index Register pair being used holds the 
‘base’ address of the table or list, and the position of the required entry is 
known relative to the ‘base’ address. 


The Stack Pointer: 
The Stack Pointer is a register pair that is used to ‘point’ to a location in 
memory in an area called the ‘stack’. 
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All microprocessors in current use require a stack, that is an area of 
memory to use as a working space for the storage of addresses or data 
on a temporary basis. Such a working area is called a stack because 
each entry is stacked next to the previous one. 

The Z80 uses a stack that ‘grows downwards’ in memory, so an 
analogy might be to a high rise block of appartments in which the first 
tenant moves into the top appartment, the next tenant into the one below 
and so on downwards. The stack is used on a first-in last-out principle, so 
the first tenant to move out will always be the latest tenant to have moved 
in. 

The stack pointer is used to point to the different locations in the stack 
in a very special way. The stack pointer always holds the address of the 
last location to have been filled. Therefore when a new entry is to be 
made, the Control Unit first arranges for the value of the stack pointer to 
be decreased by one (decremented) so as to point to the actual location 
that is to be filled. The required data is then moved to this location. 

When data is being removed from a stack the stack pointer has to be 
increased in value. 

To be a little more precise the stack pointer is always decremented 
twice when data is added to the stack, and incremented twice after data 
has been removed from the stack. This is because all data movements 
involving the stack require the handling of two separate bytes of data. 

It is an important point that strictly data is not removed from the stack 
but only a copy of the data is made, and the data still remains in the 
locations until it is overwritten at a later date. 

To the programmer the use of the stack is almost a challenge. Once 
again there are many programmers that shy away from using the stack to 
temporarily hold data, preferring to use ordinary memory locations in- 
stead. Programs that do not use the facility of the stack may not run quite 
as fast as those programs that do use the stack because moving data to 
and from the stack is very quick. 


The | register: 

This is the Interrupt Vector register. The Z80 in its normal running state 
executes sequentially the instructions in a machine code program. How- 
ever this ‘normal’ execution of a program can be ‘interrupted’. In most 
Z80 systems the ‘interrupts’ would be generated at the request of such 
devices as printers, disk units and clocks. However in the ZX-81 system 
‘interrupts’ are only used when forming the T.V. picture. 

When a device wishes to interrupt the Z80 it places a signal on the 
appropriate control line. The Z80 then responds by stopping its execution 
of the normal program and attends to the request of the device. 

Inthe ZX-81 system an ‘interrupt’ will lead to the execution of either the 
routine that is located at address 0038, or the routine that is located at 
address 0066. 
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However in larger systems many interrupt handling routines may be 
needed and the Interrupt Vector Register is used to hold the ‘high byte’ of 
the address of a ‘table of addresses’ for the different handling routines. 
When the | register is used in this way up to 128 different addresses can 
be held in a single table. 


The R Register: 

This is the Memory Refresh Register. This register is just a simple 
counter that is incremented every time an instruction or a byte of data is 
fetched from the memory. The value held in the register therefore alters 
between 0 and 255, over and over again. 

In most Z80 systems this register is used to indicate which locations in 
memory need to be refreshed (recharged) at a particular time. However 
in the ZX-81 system the R register is used to count the number of 
characters that go to form a single line of the T.V. display. 


2.5 The Arithmetic-Logic Unit: 


The Arithmetic-logic Unit, the ALU, is the last of the functional blocks of 
the 280, and it is concerned, as its name implies, which arithmetic and 
logical operations. 

lt is important to realise that the actual operations that can be 
performed by the ALU are very limited in scope. 

Simply binary addition and subtraction are possible, but not binary 
multiplication or division, as these latter operations are very complex in 
binary arithmetic. Incrementation (adding 1) and decrementation (sub- 
tracting 1) are just special cases of addition and subtraction and are 
readily managed. The unit is also able to perform a large number of ‘bit’ 
operations, by this is meant that it can assess the value of a single bit 
from within the byte held in the unit at a particular moment. 

All of the above operations are discussed fully in chapter 4. 


2.6 The Concept of machine code instructions: 


Now that the ‘hardware’ has been discussed it is appropriate to dis- 
cuss the actual structure of a machine code program. Machine code 
program instructions are usually written in an ‘assembler language’ 
format, this means that ‘mnemonics’ (words) are given to each instruc- 
tion so as to make it easier to read. Otherwise a machine code program 
would appear as a simple list of numbers in binary, hexadecimal or 
decimal arithmetic. 

There is fortunately a great similarity between the structure of a BASIC 
program and that of a machine code program. 

A BASIC program is made up of a set of BASIC lines, each with a line 
number that shows its correct position in the program, and in turn each 
BASIC line is made up of an initial command followed, if necessary, by 
further data. 
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A machine code program can have its structure described in exactly 
the same way. A program is made up of a set of instruction lines, each of 
which has allocated to it, an address in memory where the line is to be 
placed, and in turn the instruction line is made up of an initial instruction 
code followed, if necessary, by further data. 

In the ZX-81 BASIC there are only 31 commands but in the Z80 
machine code langauge there are over 500 different instructions. Fortu- 
nately though, the situation is helped by the instructions being easily 
divided into 18 smaller groups. 

The Z80 instruction codes are 1-2 bytes in length, and of the 256 
different numbers that can be held in a single byte, 252 numbers cor- 
respond to 1-BYTE INSTRUCTIONS. The remaining 4 numbers are 
used to form 2-BYTE INSTRUCTIONS. 

Throughout this book the term ‘instruction code’ is reserved for de- 
scribing the 1, or 2, bytes of the actual instruction, and where data has to 
be placed after the instruction code, this data will always be described as 
‘data’. | 

The full instruction length of the instructions in the Z80 machine code 
langauge is said to be between 1 and 4 bytes, as there are no instructions 
that taken together with any required data occupy more than 4 bytes. 

Each of the different instructions has its own mnemonic, and these 
have been chosen to explain what the instruction is actually doing. E.G. a 
simple instruction mnemonic is ‘LD A, B’ which can be expanded to give 

load a copy of the contents of the B register into the A register’. 

To illustrate the points made in this section the following diagram 
shows a few lines of machine code, together with the ‘assembler’ mne- 
monics and an attempt using BASIC to show just what the lines achieve. 

Indeed practically all machine code programs can be described in a 
PSEUDO-BASIC, and to the programmer new to machine code 
language programming, the approach can be very helpful. 
























___Machine Code Language BASIC Language 
address line No. Line 

052B 3E 78 1323 LET A=120 

052D 5F 1325 LETE=A 

052E 218204 | LD HL+048211326 LET HL=1154 
0531 19 ADD HL,DE 11329 LET HL=HL+DE 
0532 19 ADD HL,DE 1332 LET HL=HL+DE 
0533 ....... continues 1933 53% continues 


Diagram 5. An Introductory Machine Code Program 


3. The Simple Mathematics 


Absolute binary arithmetic 


As it has already been said, the Z80 holds numbers which it is manipulat- 
ing, either as 1 byte of 8 binary digits, or less commonly, as 2 bytes of 16 
binary digits. 

By saying that a number is held as an absolute binary number it is 
meant that each byte has the binary range of 0000 0000 - 1111 1111, or 
the decimal range of 0-255, and importantly there is no way that such a 
number could ever be considered to be negative. 

It is important to realise that all numbers heid in the Z80 are always 
absolute binary numbers. To a certain extent this can be shown by using 
the BASIC PEEK command, as this command will return the contents of 
any of the memory locations as a decimal number in the range 0-255. 

The following program shows this in a very simple way: 

10 SCROLL 

20 PRINT PEEK (RND*65535) 
36 GOTO 14 

RUN 

The program prints the PEEK values and it can be seen that they all lie 
in the range 0-255 decimal. 

It is also important to realise that when operations, such as addition, 
take the contents of the byte past 255 then the contents will revert to 0, 
instead of going past 255. An operation such as subtraction will cause 
the contents of a byte to return to 255 every time 0 is reached. 

This behaviour of an absolute binary number can be shown by the 
following BASIC programs: 

For the addition of ‘255+5' 

16 LET A=255 
20 LET A=A+255 
36 IF A>=256 THEN LET A=A—256 
46 PRINTA 
For the subtraction of ‘5-8’ 
16 LET A=5 
20 LET A=A-8 
30 IF A<@ THEN LET A=A+256 
46 PRINTA 

Ina Z80 system all of the numbers are in ‘absolute binary’, but often the 
programmer wishes to place a different interpretation on the value of the 
number. The commonest method in use at the present time is called ‘2’s 
complement arithmetic’, and indeed in the Z80 instruction set there are 
several instructions that have been included to help the programmer 
handle this form of arithmetic. 
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3.2 2’s Complement Arithmetic 


The concept behind ‘2’s complement arithmetic’ is very simple, but when 
it is actually used in a program the results can be very confusing. All 
machine code programmers must therefore try to become familiar with 
this important form of arithmetic. 

Simply the method enables the programmer to designate the numbers 
in the binary range 0000 0000 ~ 0111 1111 to the decimal range of 0 to 
+127, and the numbers in the binary range 1000 0000-1111 1111 tothe 
decimal range — 128 to —1. 

A result of this interpretation is to make ‘bit 7’ (the left-hand most bit) 
act as a ‘sign’ bit. This bit will have the value 0 (Reset) for positive 
numbers and the value 1 (Set) for the negative numbers. 

The following diagram illustrates the method. 


BINARY DECIMAL 
01111111 
01111110 


Positive 
numbers 


0000 0010 


0000 0001 
0000 0000 
111111711 


Negative ee u nm 


Numbers 1000 0001 


1000 0000 





Sign 
bit 
Diagram 6. 2’s complement arithmetic (1 byte) 


Fortunately there is an easy way to find the 2’s complement value of 
the decimal numbers — 128 to —1, and that is as follows: 

a) form the binary number of the absolute decimal number. e.g. to find 
the 2's complement of — 45, first find the binary equivalent to +45, which 
is 0010 1101. 

b) form the 1’s complement of this number, (simply change all the bits 
to their opposite values) e.g. 0010 1101 is changed to 1101 0010. 

c) add 1, (as you have passed zero) e.g. 1101 0010 + 0000 0001 = 
1101 0011 

The reverse of the above method can be used to convert 2’s comple- 
ment negative numbers to their decimal equivalents. 
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3.3 Hexadecimal coding 


All machine code programmers do find that any attempt to produce more 
than just a very few bytes of binary coding is just not practical. Therefore 
programmers usually use a form of shorthand for describing binary 
numbers and the commonest system to use is ‘Hexadecimal coding’. 
(Hex. coding). 

In many microcomputer systems the resultant ‘Hex-code’ can be 
entered via the monitor program directly into the computer, however the 
8K monitor program of the ZX-81 does not have this facility so the 
programmer has either to enter his machine code in decimal numbers, or 
to write for himself a Hex-loader routine in BASIC. 

The principle behind Hex. coding is once again very simple, but it takes 
a very long time to become fluent in its use, and even programmers of 
some years experience still have trouble. 

To obtain the Hex. code for a 8 bit binary number, the number is split 
into 2 groups of 4 bits, each group being called a ‘nibble’. A Hex. 
character is then assigned to represent each ‘nibble’. Hex. characters 
are the decimal numbers 0-9 and the letters A-F. 

The following table shows the different Hex. characters; 


Binary Decimal Hex. character 
0000 0 0 
0001 1 1 
0010 2 2 
0011 3 3 
0100 4 4 
0101 5 5 
0110 6 6 
0111 7 ri 
1000 8 8 
1001 9 9 
1010 10 A 
1011 11 B 
1100 12 C 
1101 13 D 
1110 14 = 
1111 15 F 


A single binary byte is therefore represented by a pair of Hex. 
characters. 


e.g. binary Hex. code 
1010 1111 = AF 

and 
0001 1110 = IE 
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A 2-byte binary number will be represented by 4 Hex. characters. 


e.g. binary Hex. Code 
1000 1000 0000 1011 = 880B 

and 
0001 0000 11110101 = 10F5 


In the rest of the book 2-byte addresses will be shown as a single group 
of 4 Hex. characters. 
The following examples show how a 4 Hex. character number can be 
converted to a decimal number. 
Example Hex. to decimal 
Hex. number = 789A 
Decimal equivalent= 7 * 4096 = 28672 
8* 256= 2048 
9* 16= 144 
+ A* 1= 10 


789A = 30874 


or if the Hex. characters are taken in pairs: 
Hex. 78 = 120 ; 120 * 256 = 30720 
Hex. 9A = 154;154* 1= 154 


= 30874 


Appendix iii. is a Decimal-Hex. conversion table and the use of such a 
table may be quicker and easier than trying to convert numbers by the 
above method. 
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4. The Z80 Machine Code 
Instruction Set 


4.1 Instructions and data 


The stage has now been reached when the actual instructions of the Z80 
machine code instruction set can be discussed in turn. 


The instructions are divided, in this book, into 18 groups, with each 


group containing the instructions that hold a strong resembiance to each 
other. 


This book follows the convention that distinguishes between the actual 


instruction, the initial 1-2 bytes, of the instruction line and the data, up to 2 
bytes, that if required is placed after the instruction proper. The total 
number of bytes in an instruction line being therefore 1, 2, 3 or 4. 


1. 


There are six classes of data that may follow instructions. They are: 


A singie byte constant. (+dd) 
i.e. anumber in the range Hex. 00-FF, decimal 0-255. 
Instructions that are requred to be followed by a single byte constant 
have this indicated in their mnemonics by there being a ‘+dd’. 
e.g. LDA,+dd 
This instruction loads the A register with a constant held in 
the next byte. 


. A2-byte constant. (+dddd) 


i.e. a number in the range Hex. OO00-FFFF, decimal 0-65535. 
Instructions that are required to be followed by a 2-byte constant have 
this indicated in their mnemonics by there being a ‘+dddd’. 
e.g. LD HL,+dddd 
This instruction loads the HL register pair with the con- 
stants held in the next 2 bytes. The first byte going into L, 
and the second going into H. 


. A2-byte address. (addr.) 


i.e. anumber in the range hex. OO000-FFFF, decimal 0-65535. 
Instructions that are required to be followed by 2 bytes of data that will 
be used as an address have this indicated in their mnemonics by 
there being a ‘adadr.’. 
e.g. JP addr. 
This instruction causes an absolute jump to the ‘address’ 
held in the next 2-bytes. (=GOTO) The first byte holds the 
low byte of the address and the second byte the high byte 
of the address. 
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4. Asingle byte displacement constant. (e) 
i.e. anumber in the range Hex. 00-FF, decimal — 128 to + 127, as the 
number is always considered to be in 2’s complement arithmetic. 
Instructions that are required to be followed by a single byte displace- 
ment constant have this indicated in their mnemonics by there being a 
‘e. 
e.g. JRe 
This instruction causes a ‘relative jump’, the displacement 
constant indicating the size of the jump. 
5. Asingle byte indexing displacement constant. (d) 
i.e. anumber in the range Hex. 00-FF, decimal — 128 to + 127, as the 
number is always considered to be in 2’s complement arithmetic. 
Instructions that are required to be followed by a sing!e byte indexing 
displacement constant have this indicated in their mnemonic by there 
being a ‘d’. 
e.g. LD A,(iX+qd) 
This instruction loads the A register with the contents of the location 
whose address is formed by the addition of 'd’ to the current value 
held in the index register pair, IX. 
6. A single byte indexing displacement constant AND a single byte 
constant. (d, +dd) 
i.e. Two bytes of data each in the range Hex. 00-FF, decimal — 128 to 
+ 127 for the first byte and 0-255 for the second byte. 
Instructions that are required to be followed by two bytes of data for 
this purpose have this indicated in their mnemonics by there being a 
‘d' and a‘+dd’. 
e.g. LD(IX+d),+dd 
This instruction loads the constant ‘+dd’ into the location, 
whose address is formed by the addition of ‘d’ to the cur- 
rent value held in the index register pair, IX. 


4.2 The Instruction Groups 


There are many ways in which the hundreds of different machine code 
instructions could be split into groups. The method chosen in this book is 
to split the instruction into functional groups, so that the reader can study 
the instructions in a group and then RUN the BASIC programs from 
chapter 5 that demonstrate those instructions. 


Group 1. The No operation and Return instructions: 


mnemonic instruction Hex. 
NOP OO 
RET C9 
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It may initially be strange to find that these two instructions should form 
the first group. However these instructions can be used alone to make 
complete machine code programs that will RUN under the BASIC USR 
command. 


The NO OPERATION instruction when executed simply results in the 
Z80 marking time for 1.23 microseconds. It is used just as ‘padding’ ina 
program or to cause short timing delays when they are needed. 

The RETURN instruction has exactly the same effect as the BASIC 
RETURN command, as it used to make a return from a subroutine. If the 
machine code program is being RUN under the USR command then the 
final RETURN instruction will cause a return to BASIC. 


The actual steps of the execution of the RETURN instruction are to 
load the Program Counter register pair with two bytes of data taken from 
the stack. The Stack Pointer register pair will have its contents in- 
cremented twice because two bytes of data have been removed. The 
first byte taken off the stack forms the low address byte and the second 
byte forms the high address byte of the Program Counter. 

A more detailed discussion of the RETURN instruction is to be found 
on page 65. 

The BASIC programs that demonstrate these instruction are to be 
found on page 83. 


Group 2. The instructions for loading registers with constants: 
The following instructions are ail involved with loading the registers 
with single byte constants: 


mnemonic instruction Hex. 
LD A,+dd 3E dd 
LD H,+dd 26 dd 
LD L,+dd 2E dd 
LD B,+dd O6 dd 
LD C,+dd OE dd 
LD D,+dd 16 dd 
LDE,+dd 1E dd 


The instruction length of all these instructions is 2 bytes, one byte for 
the instruction proper and one byte for the constant. 

The effect of all the above instructions is simply to load the specified 
register with a copy of the constant. 

The following instructions are all involved with loading register pairs 
with 2-byte constants: : 
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mnemonic instruction Hex 
LDHL,+dddd 21dddd 
LDBC,+dddd 01dddd 
LDDE,+dddd 11dddd 

LD IX,+dddd DD 21 dddd 

LD IY,+dddd FD 21 dddd 
LDSP,+dddd 31dddd 


The instruction length of these instructions will be either 3, or 4 bytes. 

The effect of the above instructions is to load the specified register pair 
with a copy of the data held in the 2 bytes held after the instruction proper. 
The first byte going to the low register, (i.e. L, C, E, X, ¥Y or P) and the 
second byte going to the high register. (i.e. H, B, D, lor S). 

The instructions in this ‘Group 2’ are some of the most commonly used 
instructions in any program. 

The loading of single byte constants is used for many different 
reasons. The following example, taken from the 8K monitor program 
shows just one use of this type of instruction. 

An example from the 8K monitor program 

In the ‘print a whole BASIC line routine’ it is necessary when 

printing the ‘cursor’ to determine whether it should be a ‘F’, 'G’, ‘K’ 

or a ‘L’ (inverted). Instructions that load the B register with the 

character codes for ‘inverse F’ or ‘inverse K’ are used. When 

‘inverse G’ or ‘inverse L’ are required, they are obtained by chang- 

ing the contents of the B register. 


address Hex. code mnemonic comment 

O7AO O6 AB LD B,+AB the ‘inverse F’ 
and 

O7A8 O6 BO LD B,+BO the ‘inverse K’ 


The instructions in ‘Group 2’ that load register pairs with 2-byte con- 
stants are also very important. The constants can either represent num- 
bers in the decimal range O-65535, or represent addresses for any 
location in memory. 

The HL, BC and DE register pairs are the ‘working’ pairs, whereas the 
IX, lY and SP register pairs are used to perform ‘special’ functions. 

The loading of constants into the ‘working’ register pairs is very 
straightforward, but the use of the indexing register pairs is worth discus- 
sing further. 

The IX and fY index register pairs are used to ‘index’ along alist, a table 
or just a block of code. The actual usage of the IY register pair in the 8K 
monitor program forms a good illustration of how the IY register pair can 
be used. 
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An example from the 8K monitor program. 

In the monitor program, at location Hex. O3F8 is an instruction 
line that results in the IY register pair being set to Hex. 4000, 
decimal 16384. 
address Hex. code mnemonic comment 
O3F8 FD 210040 LDIY,+4000 Dec. 16384 

The purpose of this line is to set the IY register pair to hold the 
‘base address of the system variables’. The value of the contents of 
the IY register pair thereafter remains unchanged, and the IY 
register pair is frequently used to ‘index’ through the system vari- 
ables. e.g. the location 16385, Hex. 4001, that holds various flags, 
is referred to as ‘lY+1’ where the value ‘1’ is the displacement 
constant. 

The BASIC programs that demonstrate these instructions are to be 
found on page 84. 


Group 3. Register copying and exchanging instructions: 

There really is a most comprehensive set of instructions for copying 
the contents of one register into another. There are also three instruc- 
tions for the copying of the contents of register pairs into the Stack 
Pointer. 

The following table gives the instruction codes for all the instructions 
that copy the contents of a single register ‘r’ into another specified 
register. 





Table of the 53 single register-to-register copying instructions. 


All the instructions in the main part of the table are very commonly 
used instructions. They are all single byte instructions and because there 
is no requirement for the Z80 to fetch any data from outside the 
microprocessor itself, the instructions are all executed very quickly. (1.23 
microseconds). 
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The special instructions for handling the contents of the Interrupt 
Vector Register and the Refresh Register are not used by the program- 
mer in most Z80 systems. | 

However, both of these specialised registers are used in the 8K 
monitor program as detailed next. 

An example from the 8K monitor program. 

In the ZX-81 system the Interrupt Vector Register is used to form 
the high part of the address of the characters in the ‘character 
generator’. The ‘character generator’ is the part of the 8K ROM that 
holds the details of the shape of each of the characters that can be 
displayed on the T.V. screen. The base address of the ‘character 
generator’ is Hex. 1E@@, and therefore the | register is loaded with 
Hex. 1E. The actual instruction lines are: 


address Hex. code mnemonic comment 
G@3F2 3E 1E LDA,+1E Load A with 

a constant. 
O3F4 ED 47 LDIA Transfer it to I. 


Although the ‘LD |,A’ instruction is a rather specialised instruc- 
tion, it still is a typical ‘single register-to-register copying 
instruction. 

The Refresh Register is also used in the 8K monitor program. It is 
loaded with a copy of the A register in the instruction lines: 


address Hex. code mnemonic comment 
0041 Load R 

& ED 4F LDR,A with a copy 
02B5 of A 


The Refresh Register is then used as a counter for the characters 
of a line as they are passed to the T.V. When the register has 
counted 32 characters a hardware interrupt is generated. 
The three instructions for copying the contents of a register pair into 
the Stack Pointer are: 


mnemonic instruction Hex. 
LD SP,HL F9 

LD SP,IX DD F9 

LD SP,IY FD F9 


The use of these three instructions is specialised but the ‘LD SP,HL’ 
instruction is used in the ‘initialisation routine’ in the 8K monitor program. 
An example from the 8K monitor program. 
In the instruction line held at O3EC is the following code: 


address Hex. code mnemonic comment 
OSEC F9 LD SP,HL Set Stack 
Pointer. 
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The effect of this line is to set the Stack Pointer so as it points to 
an area of the RAM where the stack can be put. 
In this ‘Group 3’ there are also three instructions that allow for the 
exchanging of the contents between registers. The instructions are: 


mnemonic instruction Hex. 
EX DE,HL EB 
EXX D9 
EX AF,A’F’ O8 


Of the three instructions only the ‘EX DE,HL’ instruction is concerned 
with the exchanging of the contents of registers solely within the main set 
of registers. 

The ‘EX DE,HL’ is a very useful instruction as it allows for the contents 
of the two register pairs to be switched over. This is important because 
there are certain operations that can be performed on one register pair 
and not the other. One example of such a task is the addition of two 16 bit 
numbers that can only be performed using the HL register pair. Therefore 
if anumber presently held in the DE register pair is to form part of a 16 bit 
addition,then the register pairs are exchanged, the addition performed 
and the registers exchanged back. This technique of ‘exchanging- 
performing a task-exchanging again’ is a very commonly used 
technique. 

An example from the 8K monitor program. 

In the ‘Change ail pointers’ routine’ it is, in effect, necessary to 
add the contents of the BC register pair to the contents of the DE 
register pair. Unfortunately there is no instruction to perform this 
operation using the DE register pair, but it can be done using the HL 
register pair. Hence the following method is used: 


address Hex. code mnemonic comment 
O9CO EB EX DE,HL Exchange. 
OSC ij aiveeuiordds.  ceodieeider, The addition. 
O9C2 EB EX DE,HL Exchange again 


which has the effect of: LET DE=DE+BC. 

The other two instructions are involved with the handling of the re- 
gisters in the alternate register set. 

The ‘EX’ instruction causes a switching over of the H,L,B,D and E 
registers with the H’,L’,B’,C’,D’ and E’ registers. 

The ‘EX AF,A’F” instruction is simpler in that only the A and F registers 
are switched with the A’ and F’ registers. 

Using of the alternate registers is always ‘complicated’ programming 
and the 8K monitor program uses the alternate registers frequently! 


An example from the 8K monitor program. 
The A’ and F’ registers are used to hold certain values involved in 
the production of the T.V. display in the ‘slow’ mode. 
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The following lines from the ‘slow display routine’ show the 
registers being exchanged, output signals being generated and the 
registers being exchanged back. 


address Hex. code mnemonic comment 

G211 08 EX AF,A’F’ Exchange 
registers. 

212 

to Output timing 

219 signals. 

21A 08 EX AF,A'F’ Exchange 
registers back. 


The other registers of the alternate register set are used fre- 
quently for two specific reasons. When printing a character the 
current values held in the registers are ‘preserved’ by exchanging 
register sets (but not AF) and again in the Calculator routines the 
alternate registers are used to ‘preserve’ values whilst other work is 
being done. 

The BASIC programs that demonstrate these instructions are to be 
found on page 85. 


Group 4. Instructions for the loading of registers with data copied from a 
memory location. 

The Z80 instruction set has many instructions that ‘fetch’ data from the 
memory and then ‘load’ that data into a main register. 


The address of where the data is to be found must be specified, as 
must the name of the register, or register pair, into which the data is to be 
placed. 

The instructions in this group can be divided into three subgroups that 
depend on just how the addressing of the memory is performed. 

There is: 

(a) ‘absolute addressing’ when the actual address is held as data after 
the instruction proper. 

(b) ‘indirect addressing’ when the required address is already held in 
the HL, BC or DE register pairs. 

(c) ‘indexed addressing’ when the address is formed by the addition of 
a displacement value to a ‘base’ address already held in an index register 
pair. 
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SUBGROUP A: INSTRUCTIONS USING ‘ABSOLUTE ADDRESSING’ 
The following instructions form this subgroup: 


mnemonic instruction Hex. 

LD A,(adar.) 3A addr. 

LD HL,(addr.) 2A addr. (usual form) 
or 
ED 6B addr. 
(unusual form) 

LD BC,(addr.) ED 4B addr. 

LD DE,(addr.) ED 5B addr. 

LD IX,(addr.) DD 2A addr. 

LD IY,(addr.) FD 2A addr. 

LD SP,(addr.) ED 7Baddr. 


The ‘LD A,(addr.)’ instruction is the only instruction in the whole of the 
Z80 instruction 
set that allows for a single byte of data to be copied into a single register. 
This instruction ‘load the A register with a byte of data copied from a 
memory location’ is really one of the oldest microprocessor instructions. 
lt existed on the very earliest models. However in the Z80 it is just one of 
Many instructions that is possible to use. 

An example from the 8K monitor program. 

As part of the ‘initialisation routine’ it is necessary to assess the 
size of the memory available, so as to determine whether the RAM 
is large enough to hold a ‘complete display file’. 

The instruction line held at O04B7 uses the ‘LD A,(addr.)’ to collect 
the value of the high byte of RAMTOP. 

This value is then compared to the constant Hex.4D. The result 
of this comparison shows whether or not there is 3%K available. 


address Hex. code mnemonic comment 
O4B7 3A 05 40 LD A,(4005) ~—High byte of 
RAMTOP. 
ABA- (§- ‘eikvovserien aaceetimeies Test the result. 


Note carefully how the low byte of the address has to be placed before 
the high byte of the address. 

The other instructions in this subgroup are very important instructions 
as they enable two bytes of data to be copied from memory into a register 
pair. 

The mnemonics for these instructions really are abbreviated, it can be 
helpful to consider the mnemonics should be of the form; 

e.g.LD BC, (addr). expandsto LDC,(addr.) and LD B,(addr.+ 1). 

The expansion shows that the addressed byte is copied to the low 
register of the register pair, and that the following byte is copied into the 
high register of the register pair. 
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These instructions are very commonly used in any program and the 
following example shows just two of the hundreds of occurences. 
An example from the 8K monitor program. 

In the ‘initialisation routine’ a test is made to see if the ‘current line 
with the program cursor’ comes before the ‘top program line in the 
listing’. 

In order to do this test the system variables involved are loaded 
into the HL and DE register pairs. 


address Hex. code mnemonic comment 
G41C 2AGA 40 LD HL,(4O0A) ‘E-PPC’ 
41F ED 5B 2340 LDDE,(4023) ‘S-TOP'’ 


SUBGROUP B: INSTRUCTIONS USING ‘INDIRECT ADDRESSING’ 
The instructions in this subgroup use the HL, BC or DE register pairs to 
point to the required memory location. There are instructions for loading 
the A register that use all these register pairs, but the other main registers 
can only be loaded using the HL register pair. 
The instructions are: 


mnemonic instruction hex. 
LD A,(HL) 7E 

LD A,(BC) GA 

LD A,(DE) 1A 

LD H,(HL) 66 

LD L,(HL) 6E 

LD B,(HL) 46 

LD C,(HL) 4E 

LD D,(HL) 56 

LD E,(HL) 5E 


All of the instructions in this subgroup have an instruction length of 1 
byte. 


It is important to point out that these instructions result in the loading 
of just one byte of data into a single register. 


These instructions are once again very common instructions and the 
example below shows instructions from this subgroup being used twice 
to load a register pair with two bytes of data that were held together in the 
memory. 

An example from the 8K monitor program. 

The ‘Change all pointers routine’ is a very frequently used 
routine. It is used to increase or decrease the values of the 9 main 
pointers. i.e. D-File, DF-CC ... STKEND, which are the system 
variables 16396 to 16413. 
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The pointers require to be changed whenever characters are 
added, or removed, from the program area. 

In order to pick up the pointers in turn, the HL register is set to the 
‘base address of the list and then stepped along the list. ‘LD E,(HL)’ 
and ‘LD D,(HL)’ instructions are used to ‘pick-up’ the required 
values. 

The following instruction lines show just the ‘pick-up’ part of the 
routine. 


address Hex. code mnemonic comment 

@9AF 210C 40 LD HL,+4O00C Set base pointer 
9B2 3E 69 LD A,+@9 9 variables 
9B4 5E LD E,(HL) Low byte to E 
9B5 23 INC HL Increase pointer 
9B6 56 LD D,(HL) High byte to D 


(the ‘INC HL’ instruction will be explained in more detail on 
page 39.) 


SUBGROUP C: INSTRUCTIONS USING ‘INDEXED ADDRESSING’. 
The instructions in this subgroup allow the programmer to load the: 
main single registers with a copy of a byte of data specified as being held 
in a table, list or just a block of code. The base address already being held 
in the IX or IY register pairs. 
The following diagram shows how the different values of the displace- 
ment constant are used to form the addresses of the entries in the table. 





IY+7F’ | TOP 


W+7E 
IY +02 Table, List or 
‘IY+01' just a block of 
TY +00’ memory 
ios is TY+FF (256 locations) 
location's 4WY+FE 
address i 


WY+81' 
wy+go7 | BOTTOM 


Diagram 7. To show the IY register pair being used to 
address a table of 256 locations. 
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The actual instructions in this subgroup are: 


mnemonic instruction hex. 
LD A,(IX+d) DD 73d 
LD H,(IX+d) DD 66d 
LD L,(IX+d) DD6Ed 
LD B,(IX+d) DD 46d 
LDC,(IX+d) DD4Ed 
LD D,(iX+d) DD 56d 
LD E,(IX+d) DD 5Ed 


Note for the IY Instructions change: 
IX to '¥ and DD to FD 
In the 8K monitor program the IY register pair always holds the value 
Hex. 48G@ which corresponds to the base address of the system vari- 
ables. The IX register pair is used in the ‘dispiay’ routine as a store for a 
‘return address’ and is therefore not available to the programmer unless 
programs contain their own ‘display’ routine. 
An example from the 8K monitor program. 
The individual system variables are often ‘picked-up’ using the 
instructions in this subgroup. 
The following instruction line from part of the ‘Clear screen 
routine’ is used to ‘pick-up’ the system variable ‘DF-SZ’ which is the 
‘number of lines in lower part of screen’ variable, 16418. 


address Hex. code mnemonic comment 

GATF FD 46 22 LD B,(IY+22) Load B with 
system variable 
16418, DF-SZ 


The BASIC programs that demonstrate these instructions are to be 
found on page 87. 
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Group 5. Instructions for loading locations in memory with data copies 
from registers, or with constants. 

The instructions in this group perform operations that in general are the 
opposite of those described in group 4. 

The instructions that form this group allow for the contents of the main 
registers to be copied to addressed locations in the memory, or for 
constants to be loaded into these locations. 

The instructions can again be divided into three subgroups that each 
uses its own mode of addressing. 


SUBGROUP A: INSTRUCTIONS USING ‘ABSOLUTE ADDRESSING’ 
The following instructions form this subgroup: 


mnemonic instruction Hex. 


LD (addr.),A 32 addr. 
LD (addr.),HL 22 addr. (usual form) 
or 
ED 63 addr. (unusual form) 
LD (addr.).BC ED 43 addr. 
LD (addr.),DE &D53 addr. 
LD (addr.),1X DD 22 addr. 
LD (addr.),lY FD 22 addr. 
LD (addr.),SP ED73 addr. 


Note that there is no instruction for directly storing a constant in an 
absolutely addressed memory location. 

Once again the only register that can be copied, as a single register, is 
the A register. All of the other instructions involve the moving of two bytes 
of data. It is the contents of the LOW register of the register pair that is 
copied into the addressed location, and the contents of the HIGH register 
that goes into the following location. 

The instructions that use ‘absolute addressing’ are very commonly 
used and the following example shows the whole of the ‘CLEAR com- 
mand routine’. 


An example from the 8K monitor program 

In the BASIC interpreter there are routines for each of the 31 
BASIC commands. The CLEAR command has one of the simplest 
routines. When it is called, the routine loads a Hex.80 into the first 
location of the VARIABLE area. Then the address of the next 
location is stored as the E-LINE, STKBOT and STKEND system 
variables using instructions from this subgroup. The effect of these 
operations is to ‘empty’ the variable area and the workspace. 
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address 
1496 
1499 
149B 


149C 
149F 
14A2 
14A5 
14A8 


Hex. code 
2A 10 4G 
36 80 

23 


22 1446 
2A 14 46 
22 1A 4G 
22 1C 40 
C9 


mnemonic 
LD HL,(4010) 
LD (HL),+80 
INC HL 


LD (4014),HL 
LD HL,(4014) 
LD (401A),HL 
LD (401C),HL 
RET 


comment 
Pick-up VARS 
Enter Hex. 8@ 
Move on one 
place. 

E-LINE set. 
Restore HL 
STKBOT set. 
STKEND set. 
Return. 


The ‘LD (HL),+8@’ instruction is one of the instructions to be 
included in subgroup b. (see below). The ‘INC HL’ instruction is 


dealt with more fully on page 39. 


Note that as the routine stands the instruction line containing the 
instruction ‘LD HL,(4014)’ is superfluous. It is present because the 
later instructions of the routine also form part of the RUN sequence, 
which does perform a CLEAR operation whenever it is called. 


SUBGROUP B: INSTRUCTIONS USING ‘INDIRECT ADDRESSING’ 
The instructions in this subgroup allow for a copy of the A register to be 
stored in a location addressed by the HL, BC or DE register pairs, and for 
the contents of the other main registers to be stored in a location addres- 
sed only by the HL register pair. The HL register pair can also point to a 


location that is to be loaded with a single byte constant. 


It is also convenient to include in this subgroup three rather specialised 
instructions that allow the contents of HL, IX or IY register pairs to be 


exchanged with the last two bytes of data on the stack. 
The actual instructions are: 


The instructions of this subgroup are often used to ‘put-back’ values 
following some sort of manipulation. 


mnemonic 
LD (HL),A 
LD (BC),A 
LD (DE),A 
LD (HL),H 
LD (HL),L 
LD (HL),B 
LD (HL),C 
LD (HL),D 
LD (HL),E 
LD (HL),+dd 
EX (SP),HL 
EX (SP),1X 
EX (SP), IY 


instruction Hex. 
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An example from the 8K monitor program 

in the two earlier examples that use the ‘Change ail pointers’ 
routine (pages 27 and 30) it was shown that the values of the 
pointers are ‘picked-up’ in turn, and then manipulated. The follow- 
ing instruction lines show how the results are ‘put-back’ using 
instructions from the present group under discussion. 


address Hex. code mnemonic comment 
09C3 72 LD (HL),D Put-back 
high byte. 
09C4 2B DEC HL Decrease 
pointer 
09C5 73 LD (HL),E Put back 
low byte. 


The instruction ‘DEC HL’ will be discussed in detail on page 42. 

An exampie showing the use of the ‘LD (HL), +dd’ instruction is to be 
found on page 34. 

The three more specialised instructions that use ‘indirect addressing’ 
all involve the exchanging of the last two bytes on the stack with those 
bytes addressed by the HL, IX or lY register pair. 

These instructions can be used in many instances, and the following 
example shows how the ‘EX (SP),HL’ instruction is used in the 8K 
monitor program. 

An example from the 8K monitor program 

The use of the stack by the BASIC interpreter is rather comp- 
licated as part of the stack area is used to hold the ‘return line 
numbers’ for the GOSUB-RETURN command and another part of 
the stack is used as the ‘normal’ working stack. 

When a GOSUB command is executed the appropriate values 
are put into the GOSUB STACK, and when a RETURN command is 
executed, these values are collected. However the interpreter must 
check for the ‘RETURN without GOSUB'’ error condition. 

This is done using the ‘EX (SP),HL’ instruction. If there are no line 
numbers on the stack to be used as return line numbers then the 
high byte taken off the stack will be Hex. 3E. 

Therefore the interpreter checks that the high byte on the stack is 
not Hex. 3E, if it is then error ‘7’ is signalled. 

The actual lines are: 


address Hex. code mnemonic comment 
GED9 E3 EX (SP),HL Collect stack 
values. 
EDA 7C LD A,H High byte to 
A register 


... followed by test against Hex. 3E. Error 7 if equals Hex. 3E. 
Proceed to use line number, if not Hex. 3E. 
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SUBGROUP C: INSTRUCTIONS USING ‘INDEXED ADDRESSING’. 

The instructions in this subgroup allow the programmer to copy the 
contents of the main registers into an indexed addressed location, or to 
load a constant into the location. 


The instructions are: 
mnemonic instruction Hex. 


LD(IX+d),A  DD77d 
LD(IX+d),H DD74d 
LD(IX+d),L  DD75d 
LD (IX+d),B  OD70d 
LD(IX+d),C DD71d 
LD(IX+d),D DD72d 
LD(IX+d),E D0D73d 
LD (IX+d),+dd DD36ddd 


Note for the IY instruction change: 

IX to Y and DD to FD 

These instructions are used in the ‘opposite’ way to the instructions in 
group 4c. 

The following example shows how a constant can be loaded into a 
location in a table as long as the ‘base address’ has been specified and 
the ‘displacement’ is known. 

An example from the 8K monitor program 

When the power is connected to the ZX-81, the computer enters 
‘slow’ mode. The entry into this mode is not at random but arranged 
by the following line: 


address Hex. code mnemonic 
OG3FC FD 36 3B 40 LD (403B),+40@ 


This line from the ‘initialisation’ routine sets the flags of the 
system variable CD-FLAG, 16443, now with Bit 6 set (not bit 7) the 
computer will be in ‘slow’ mode until a change is made by the 
programmer. 

The BASIC programs that demonstrate these instructions are to be 
found on page 89. 


Group 6: The Addition Instructions. 

The instructions in this group are the first instructions for handling 
arithmetic operations that are to be discussed. Later groups of instruc- 
tions show how the Z80 can handle subtraction, comparison and logical 
operations. 

The Addition instructions add in absolute binary arithmetic a specified 
number to the contents of a single register, a register pair or an indexed 
addressed location in memory. 

The instructions in this group can be divided into three subgroups, with 
each subgroup having instructions with its own mnemonic type. 
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The subgroups are: 

(a) The ADD instructions. These are straightforward addition 
instructions. 

(b) The INC instructions. INCrementation just adds 1 to a specified 
number. 

(c) The ADC instruction. These instructions are identical to the ADD 
instructions except that if the ‘CARRY FLAG’ is Set then the result of the 
addition is incremented as well. 

Before the instructions in the group are discussed it is appropriate to 
describe the ‘CARRY FLAG’ in more detail. 


The Carry Flag: 

In reality the Carry flag is bit @ of the F register. It is used in many 
different instances, but as an introduction to its function, the Carry flag 
can be considered to often act as an extra bit for the A register. 

Normally the A register is described as having 8 bits, numbered 6-7. 
Bit @ is the right hand bit, the least significant bit, and bit 7 is the left hand 
bit, the most significant bit. However it is useful in many instances to 
consider the Carry flag as an 8th. bit to the register. 

Note however that the Carry flag is just a bit in a different register and 
can be considered to be the 8th. bit of practically all the registers and not 
just the A register. 

In respect of the Addition instructions the following statements can be 
made: 

i. The ADD instructions ignore the state of the Carry flag before 
performing the addition, but Set (give value 1) the flag if the addition 
generates an extra binary digit, and Reset (give value @) if not. 

i.e. Hex. 

60 + 6C = CC Carry will be RESET 
60 + AC = @C Carry will be SET. 

The addition of Hex. 6G + AC will give @C when restricted to the 8 bits 
of a register, but the overflowing of the register leads to CARRY SET. 

ii. The INC instructions do not take any notice of the Carry flag, and 
the result of an INC operation does not affect the Carry flag. 

iii. The ADC instructions include the present state of the Carry flag in 
their additions, and leave the Carry flag Reset, or Set, depending on the 
final result of the ADC operation. 

i.e. Hex. 

@1+60 + 6C = CD Carry will be RESET 
@1 +60 = GD Carry will be SET. 
CARRY 

FLAG 

SET | 

With the Carry Flag Reset initially the results will be Hex.CC and @C as 
before. 
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SUBGROUFP A: THE ADD INSTRUCTIONS; 
The instructions are: 


mnemonic instruction Hex mnemonic _ instruction Hex 


ADD A, +dd C6 dd ADD HL,HL 29 
ADDA,A 87 ADDHL,BC 69 
ADD A,H 84 ADD HL,DE 19 
ADD A,L 85 ADD HL,SP 39 
ADD A,B 80 ADD IX,IX DD 29 
ADD A,C 81 ADD IX,BC DD 69 
ADD A,D 82 ADD IX,DE DD 19 
ADDA,E 83 ADD IX,SP DD 39 


ADD A,(HL) 86 
ADDA,(IX+d) DD 86d 


Note for the IY instructions change: 
1X to lY and DD to FD 

The ADD instructions are really very straightforward instructions, and 
are frequently used. 

There are many instructions for forming the result of an addition in the 
A register, when dealing with single bytes, and the HL register pair when 
dealing with 2-byte numbers. However it is never possible to perform an 
addition and get the result directly in any of the other registers. 

A good example of the use of an ADD instruction is given by the 
following example from the ‘Keyboard decode routine’. 

An example from the 8K monitor program. 

There are 78 different keyboard codes generated by the 78 
different keys on the keyboard of a ZX-81. In the ‘keyboard decode 
routine’ these codes are arranged so as to be in the range decimal 
1-78, Hex. 01-4D. The appropriate characters for these codes are 
to be found in the ‘character table’ at Hex. 007E to OOCB inclusively. 

For example the ‘A’ key will give a keyboard code of value ‘5’, and 
the fifth character in the ‘character table is decimal 38, Hex. 26, 
which is the ZX-81 code for the letter ‘A’. 

The ‘character table’ at Hex. @@7E-@G@CB is for the ‘L-mode’. The 
table at Hex. @@CC-@G@F2 is for ‘F-mode’ and the table at Hex. 
G@F3-6 11 is for ‘G-mode’ 

The ‘keyword table’ is at Hex.6111-@1FB. 


address Hex. code Mnemonic comment 
07D5 217D60 LDHL,+@@07D Setbase 
address. 
7D8 5F LDE,A Transfer to E. 
7D9 19 ADD HL,DE Form new 
address. 
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The routine operates with the keyboard code being originally in 
the A register. The base address is put into the HL register pair and 
the keyboard code is added to the base address. The D register 
holds zero throughout the routine. (see page 153 for the full ‘Key- 
board decode routine). 
SUBGROUP B: THE INC INSTRUCTIONS 

The instructions in this subgroup are used to add 1 to a specified 8 bit, 
or 16 bit number. The addition is in absolute binary arithmetic. The 
instructions neither take note of the Carry flag nor let the result of the 
addition affect the Carry flag. 

The actual instructions are: 


mnemonic instruction Hex mnemonic _ instruction Hex 


INC A 3C INC HL 23 
INCH 24 INC BC G3 
INCL 2C INC DE 13 
INC B G4 INC SP 33 
INC C GC INC Ix DD 23 
INC D 14 INC IY FD 23 
INCE 1C 

INC (HL) 34 


INC (IX+d) DD 34d 

INC (IY +d) FD 34d 

Examples showing the use of INC instructions can be found on pages 
31 and 34. 
SUBGROUP C: THE ADC INSTRUCTIONS 

The instructions in this subgroup enable the programmer to perform 
the addition between 8 bit, and 16 bit numbers, taking into account the 
present state of the Carry flag. The result of the addition is unchanged if 
the Carry flag is Reset, but incremented if the Carry flag is Set. 

All the ADC instructions Set, or Reset, the Carry flag depending on the 
result of the final addition. 

The actual instructions are: 

mnemonic _ instruction Hex mnemonic _ instruction Hex 


ADC A,+dd CE dd ADC HL,HL ED 6A 
ADC A,A 8F ADC HL,BC  ED4A 
ADC A,H 8C ADCHL,DE EDS5A 
ADC A,L 8D ADC HL,SP ED 7A 
ADC A,B 88 
ADC A,C 89 
ADC A,D 8A 
ADC A,E 8B 


ADC A,(HL) 8E 
ADC A,(IX+d) DD8Ed 
ADCA,(l¥Y+d) FD8Ed 
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The ADC instructions are not commonly used codes unless it is 
important to consider the ‘carry’ when using ‘multiple precision arith- 
metic’. In such a case the ‘carry’ between bytes enables the programmer 
to hold numbers in more than two bytes. 

The following example from the 8K monitor program however shows 
the Carry flag being used in the ‘PRINT command routine’. 


An example from the 8K monitor program 

In the ‘PRINT command routine’ the characters for ‘comma and 
semi-colon’ have to be separated from the other characters. This is 
performed by arranging that: for the ‘comma’, the A register holds 
Hex. GG with Carry Reset and for the ‘semi-colon’ that the A register 
holds Hex.FF with Carry Set. 

The routine then uses the ADC instruction. The effect of this 
being that the A register will hold Hex. @@ for both the ‘comma’ and 
the ‘semi-colon’. 


address Hex code mnemonic Comment 
GAD7 CE 0G ADC A,+@@ Just add the 
Carry. 


The BASIC programs that demonstrate these instructions are to be 
found on page 92.. 


Group 7. The Subtraction Instructions. 

The Subtraction instructions allow the programmer to subtract, using 
absolute binary arithmetic, a specified number from the contents of a 
single register, a register pair or an indexed addressed location in 
memory. 


As with the Addition instructions, the Subtraction instructions can be 
divided into three subgroups, each with its own mnemonic. | 

There are: 

(a) The SUB instructions that allow for single byte numbers to be 
subtracted from the contents of the A register. 

(b) The DEC instructions that allow for the special case of subtracting 
1 from a specified byte, or register pair. 

(c) The SBC instructions that allow for the subtraction of the present 
value of the Carry flag as well as the normal subtraction. 

in respect of the Subtraction Instructions the following statements can 
be made: 

i. The SUB instructions are not affected by the present state of the 
Carry flag. However the Carry flag will be Reset if the result of the 
subtraction is correct, and Set if the result is incorrect because zero has 
been passed. 
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€.g 


in decimal 220-205 = 15 with CARRY RESET 
in Hex. DC -CD = OF 

in decimal 208 - 208 = 0 with CARRY RESET 
in Hex. DO - D@ = 0¢ 

in decimal 215 - 216 = 255 with CARRY SET 
in Hex. D7 = D8 = FF 


In effect ‘Greater than’ or ‘Equals’ gives RESET and ‘Less than’ gives 
SET. | 

li. The DEC instructions do not take any notice of the Carry flag and 
the result of a DEC operation does not affect the Carry flag. 

iii. The SBC instructions include the present state of the Carry flag into 
their subtractions. The result of the SBC operation also affects the Carry 
flag. 


SUBGROUP A. THE SUB INSTRUCTIONS 
The instructions in this subgroup are: 


mnemonic instruction Hex. 
SUB +dd D6 dd 

SUBA 97 

SUB H 94 

SUBL 95 

SUB B 90 

SUB C 91 

SUB D 92 

SUBE 93 

SUB (HL) 96 


SUB (IX+d) DD 96d 
SUB (IY+d) FD 96d 


The SUB instructions are the normal instructions for performing sub- 
traction on single byte numbers, and are therefore commonly used 
instructions. 

The following example shows the ‘SUB +dd’ instruction. 


An example from the 8K monitor program. 

In the previous example from the ‘PRINT command routine’ 
(page 40) it was said that the A register is made to hold: for the 
‘comma’ the value Hex. @@ with Carry Reset and for the ‘semi- 
colon’ the value Hex. FF with Carry Set. 

These results are the direct result of the following line where the 
constant value Hex. 1A, decimal 26, is subtracted from the ‘charac- 
ter codes’ for ‘comma’ and ‘semi-colon’ held in the A register. 
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Address Hex. code mnemonic comment 
G@AD5 D6 1A SUB +1A Simply 
subtract ‘26’ 

For a ‘comma’ 

Indecimal26-—26  =9 Carry Reset. 

In Hex. 1A— 1A = 0G 
For a ‘semi-colon’ 

Indecimal25—26 = 255 Carry Set 

In Hex. 19—1A = FF 


SUBGROUP B. THE DEC INSTRUCTIONS 
The instructions in this subgroup are: 


mnemonic instruction Hex mnemonic instruction Hex 


DECA 3D DEC HL 2B 
DEC H 25 DEC BC 6B 
DEC L 2D DEC DE 1B 
DEC B G5 DEC SP 3B 
DECC QD DEC Ix DD 2B 
DEC D 15 DEC IY FD 2B 
DECE 1D 


DEC (HL) 35 
DEC (IX+d) DD35d 
DEC (IX+d) FD35d 


The DEC instructions are commonly used instructions when dealing 
with ‘counters’ and ‘pointers’. The following example shows the ‘DEC HL’ 
instruction being used four times in quick succession in the ‘Initialisation 
routine’ where the HL register pair is being used as an address pointer. 

An example from the 8K monitor program 

Part of the ‘Initialisation routine’ involves loading the value Hex. 

3E into the first location of the stack, (see also example on page 35) 

and then setting the Stack Pointer and the system variable ERR- 

SP, 16386, to their correct initial values. 


Address Hex. code mnemonic comment 

O3E5 2A 0440 LD HL,(4004) Fetch 
‘RAMTOP'’ 

3E8 2B DEC HL Point to 1st loc. 

3E9 36 3E LD (HL),+3E ‘return’ marker 

3EB 2B DEC HL Miss a location 

3EC F9 LD SP,HL Store on SP 

3ED 2B DEC HL Miss one 

SEE 2B DEC HL Miss one 

SEF 22 02 4G LD (4062),HL Store as 
‘ERR-SP’ 
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SUBGROUP C: THE SBC INSTRUCTIONS 

The SBC instructions allow the programmer to perform subtraction 
taking into account the value of the Carry flag. There are SBC instruc- 
tions for handling both single byte and 2-byte subtractions. 

Note that the SBC instructions will not give the correct result of a 
subtraction operation unless the Carry flag is initially Reset. This can bea 
problem when dealing with 2-byte subtractions as there are no SUB 
instructions for handling 2-byte operations. 

The usual way of ‘clearing’ (resetting) the Carry flag is to use the ‘AND 


A’ instruction (see page 45). 


The instructions in this subgroup are: 


mnemonic 
SBC A,+dd 
SBC A,A 
SBC A,H 
SBC A,L 
SBC A,B 
SBC A,C 
SBC A,D 
SBC A,E 
SBC A,(HL) 


SBC A,(IX+d) DD9Ed 
SBC A,(IY+d) FD9Ed 


OF 
9C 
9D 
98 
99 
9A 
9B 
9E 


instruction Hex mnemonic 
DE dd 


SBC HL,HL 
SBC HL,BC 
SBC HL,DE 
SBC HL,SP 


instruction Hex 


ED 62 
ED 42 
ED 52 
ED 72 


Whereas the ADC instructions are uncommon the SBC instructions 
are widely used for many different reasons. 
The following example shows the ‘SBC HL,DE’ instruction being used 


to compare two 16 bit numbers. 


An example from the 8K monitor program 

The ‘print a whole BASIC line routine’ is used to print an ex- 
panded BASIC line, replacing ‘tokens’ with appropriate ‘words’, i.e. 
character code 234 with the word REM. etc. It is also this routine 
that adds the ‘inverse S’ that shows a syntax error. 

When the ‘syntax checking routine’ finds an error the appropriate 
address is stored as system variable 16408, X-PTR. 

As the ‘print a whole BASIC line routine’ prints each character, a 
check is made to determine whether or not an ‘inverse S’ should be 
printed instead. The following lines show how the addresses are 
compared using a SBC instruction. 


address 

076D 
7/1 
774 
775 


Hex. code 
ED 48 18 4G 
2A 16 40 
A7 

ED 42 


mnemonic 


LD BC,(4018) 
LD HL,(4016) 


ANDA 
SBC HL,DE 
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comment 
Pick-up X-PTR 
Pickup CH-ADD 
Clear Carry flag 
Compare 
addresses. 


... and print an ‘inverse S’ if the addresses match, this will be 
shown by the result being zero. 

The BASIC programs that demonstrate these instructions are to 
be found on page 94. 


Group 8: The Compare Instructions 

The number of instructions in this group is very small, but the 
instructions are some of the most commonly used instructions in 
any machine code program. 

The Compare instruction allows the programmer to compare the 
current contents of the A register with another byte of data. As usual! 
this second byte of data can be a constant, the contents of a main 
register or the contents of an indexed addressed location in 
memory. 

The Compare instructions perform a subtraction operation (with- 
out Carry) but the result is discarded after being used in the setting 
of the flags in the flag register. 

The most important flag is the Carry flag and this is affected in the 
same manner as with the subtraction instructions. An operation in 
which the contents of the A register is ‘Greater than’ or ‘Equal’ to the 
second byte of data will RESET the Carry flag, whereas an opera- 
tion with the contents of the A register being ‘Less than’ the second 
byte will SET the Carry flag. 


The instructions are: 


mnemonic instruction Hex. 
CP +dd FE dd 
CPA BF 
CPH BC 
CPL BD 
CPB B8 
CPC B9 
CPD BA 
CPE BB 

CP (HL) BE 

CP (IX+d) DD BEd 
CP (IY +d) FD BEd 


There are also block compare instructions but these are considered on 
page 72. 
In the monitor program there are literally hundreds of comparisons and 


the following example illustrates the ‘CP H’ instruction, where the con- 
tents of the A register is compared to the existing contents of the H 


register. 
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An example from the 8K monitor program 

As part of the initialisation of the ZX-81 there is a check made on 
the memory to determine just how much memory is available for 
use. This ‘RAM check routine’ tries to load the Hex. value @2 into 
every location between Hex. 7FFF and 400@. When a 16K RAM 
pack is fitted there will be a real location available for each attempt, 
but when less memory is fitted, the ‘RAM check routine’ will fail to 
load the actual location. Following the loading of the memory the 
routine continues by reading each location in turn, starting at Hex. 
400G@, until it finds a location that does not contain the value Hex. 
@2. The address of that location becomes RAMTOP. 

A ‘CP H' instruction is used in the following lines to test whether 
or not the contents of the H register has reached Hex. 3F as the 
routine goes down through the memory, entering the value Hex. 
G2. 


address Hex. code mnemonic comment 

GGG2 01 FF 7F LD BC,+7FFF Set BC to top of 
possible RAM. 

3CB 60 LD H,B Transfer BC 

3CC 69 LDL,C to HL. 

3CD 3F 3E LD A,+3F Load A. 

3CF 36 G2 LD (HL),+@2 The Hex. G2. 

3D1 2B DEC HL Next location. 

3D2 BC CP H The comparison 


. .and back to @3CF if not ‘equal’. 

Note that the BC register is set to Hex. 7FFF in instruction line 
Q0@2, as part of the power-on procedures. 

The NEW command will use the RAM check routine to check up 
to RAMTOP by entering the routine at @3CB rather than @66@ as 
the value of RAMTOP may have been altered by the programmer in 
the meanwhile. 


The BASIC program that demonstrates an instruction from this group 


is to be found on page 95. 


Group 9: The Logical Instructions 
There are instructions for performing the logical operations of AND, 


OR and XOR. These operations are performed between the contents of 
the A register and a specified byte. 


Each subgroup will now be discussed in turn: 


SUBGROUP A: THE AND INSTRUCTIONS 


The logical operation AND allows the programmer to ‘AND’ the indi- 


vidual bits of the A register with the corresponding bits of a specified byte. 


The result of the 8 operations is returned to the programmer in the A 


register. 
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The AND operation specifies that the resultant bit of the test between 
two bits will be Set only if both of the bits under test are themselves Set. 
Otherwise the resultant bit will be Reset. 


e.g. 10101010 AA 
in binary AND AND 
11000000 in Hex. CO 
results in results in 
10000000 80 


The effect of the AND operation can be summarised as being an 
operation that KEEPS certain bits in the A register, or MASKS OFF the 
other bits, depending on the point of view that is taken. 

In the example above the operation of ‘AND + CO’ will result in the 
KEEPing only of the Bit 6 & the Bit 7 in the A register; or the MASKing 
OFF of Bits @-5 inclusive. 

The AND instructions also clear the Carry flag, and hence ‘AND A’ is 
often used as the ‘clear carry flag’ instruction. 

The instructions in this subgroup are: 


mnemonic instruction Hex. 
AND +dd E6 dd 

ANDA A7 

AND H A4 

ANDL A5 

AND B A@ 

AND C Al 

AND D A2 

AND E A3 

AND (HL) A6 


AND (IX+d) DD A6d 
AND (IY +d) FD A6d 


The following example shows the ‘AND +dd’ instruction being used to 
MASK OFF two bits. 
An example from the 8K monitor program. 
The ‘Keyword table’ at 0111 - 01FB holds the expanded forms of 
all keywords. 
e.g. the keyword LIST is held as: 


Hex. 31 inlocation01AF 
Hex.2E inlocation 01B0 
Hex. 38 inlocation 01B1 
Hex. B9 inlocation 01B2 


where the character code for ‘L’ is Hex. 31, for ‘I’ is Hex. 2E, for ’S' is 
Hex. 38, and the character code Hex. B9 is an ‘inverted T’ that 
marks the end of the word. 
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In the ‘print keyword routine’ are the instructions that find the 
appropriate word for a particular keyword code. The letters of the 
word are then printed on the T.V. display in the following manner: 

Each letter is ‘ANDed’ with Hex. 3F. This removes nothing from 
the normal letters but removes the ‘inverting’ from the last letter of 
the word. 

The letter is then printed. 

The letter is fetched again and tested at this point to find out 
whether or not it is a ‘last letter’. 

The test is performed by ‘doubling’. The double of an ordinary 
number will give Carry Reset, whereas the double of an inverse 
character will give Carry Set. 


The instruction lines are: 


address Hex. code mnemonic comment 
0959 GA LD A,(BC) Pick-up letter. 
95A E6 3F AND +3F Mask-off 
bits 6 & 7. 
... print the character. 
95D GA LD A,(BC) Fetch letter 
again. 
95E 03 INC BC Move pointer 
forward. 
95F 87 ADD A,A Test by doubling 


... return to 9959 if Carry Reset. 


SUBGROUP B: THE OR INSTRUCTIONS 

The logical operation OR allows the programmer to ‘OR’ the individual 
bits of the A register with the corresponding bits of a specified byte. 

The OR operation specifies that the resultant bit of the test between 
two bits will be Set only if either of the bits under test are themselves Set. 
Otherwise the bit will be Reset. 


e.g. 1010101@ AA 
in binary OR in Hex. OR 
110000G0@ CO 

results in results in 
1110101@ EA 


The OR instructions are not very commonly used instructions and indeed 
they can usually be avoided completely if it is wished. However there are 
certain times when the use of an OR operation is the easiest way of 
performing the operation. | 

Whereas the effect of the AND operation was to MASK OFF certain 
bits, the OR operation SETS certain bits. 
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The OR instructions are: 


mnemonic instruction Hex. 
OR +dd F6 dd 
ORA B7 
ORH B4 
ORL B5 
ORB BO 
ORC B1 
ORD B2 
ORE B3 

OR (HL) B6 

OR (IX+d) DD B6é d 
OR (IY +d) FD B6d 


The following example shows the ‘OR +dd’ instruction being used to 
SET bits 5, 6 and 7 of the A register. 


An example from the 8K monitor program. 

The ‘keyboard decode routine’ of the 8K monitor program allows 
for the keyboard to be scanned eight times. On each scan the 
address bus holds a different address so in effect the keyboard is 
scanned from ‘eight different directions’, one after another. 

There are only five data lines coming from the keyboard and it is 
necessary to Set the three unused lines so that their contents are 
predictable. 

The following line performs this operation: 


address Hex. code mnemonic comment 

G2C5 F6 EG OR +E@ Sets bits 5,6 & 7 
so as to make 
them predictable 


(see page 153 for full ‘Keyboard decode routine’) 


SUBGROUP C: THE XOR INSTRUCTIONS 
The logical operation XOR allows the programmer to ‘XOR’ the indi- 
vidual bits of the A register with the corresponding bits of a specified byte. 
The XOR operation specifies that the resultant bit of the test between 
bits will be Set only if either, but not both, of the bits under test are 
themselves Set. Otherwise the bit will be Reset. 


e.g. 101010190 AA 
in binary XOR in Hex. XOR 
110000606 CG 
results in results in 
01101010 6A 
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Once again the instructions in this group are uncommon instructions, 
and their use can usuaily be completely avoided. However the ‘XOR A’ 
instruction can be useful as it has the effect of clearing the A register in 
just a single byte of machine code. It does however also clear the Carry 
flag which may not be always helpful. 

The actual instructions are: 


mnemonic instruction Hex. 
XOR +dd EE dd 

XORA AF 

XOR H AC 

XOR L AD 

XOR B A8 

XOR C AQ 

XOR D AA 

XOR E AB 

XOR (HL) AE 


XOR (1X+d) DD AE d 
XOR (lY +d) FD AE d 


Apart from the use of the ‘XOR A’ instruction to clear the A register, the 
use of the XOR instructions is always complicated programming. The 
following example from the monitor program shows how string variables 
are marked as string variables. 

An example from the 8K monitor program. 

A string variable is marked as being a string variable by having bit 

7 RESET, bit 6 SET and bit 5 RESET. This is achieved in the 

‘Assignment of a string variable routine’ as follows: 

The address of the single letter of the name is loaded into the HL 
register pair. 

Then by using a ‘XOR HL’ instruction the character code for the 
letter is XORed against Hex. 60. This has the effect of Resetting bit 

7, Setting bit 6 and inverting bit 5 which will always give a Reset 

value. 


The lines are: 
address Hex. code mnemonic comment 
13C4 3E 60 LD A,+6@ Load A with 
Hex. 60 
13C6 2A 1240 LD HL,(4012) Pick-up address 
13C9 AE XOR (HL) Change bits. 


The BASIC programs that demonstrate these instructions are to be 
found on page 96. | 
Group 10. The Jump Instructions. 

In the Z80 instruction set there are 17 instructions that allow the program- 
mer to make jumps from one part of his program to another. 
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The instructions can be split into seven subgroups depending on the 
type of jump involved. 
Each subgroup will now be discussed in turn: 


SUBGROUP A: THE ABSOLUTE JUMP INSTRUCTION 

The single instruction in this subgroup is the simplest of all the Jump 
Instructions. The instruction uses absolute addressing to specify the 
address to which the jump is to be made. 

The instruction is: 


mnemonic instruction Hex. 
JP addr. C3 addr. 


This instruction is directly equivalent to the BASIC ‘GOTO’ command. 

The execution of this command does not take any notice of the present 
state of any of the flags and does not affect any of the flags. The result of 
the instruction is simply to load the Program Counter register pair with the 
specified address. 

The instruction is used simply to move from one block of code to 
another, past subroutines and tables in particular. 

An example from the 8K monitor program. 

The first occurrence of an absolute jump instruction comes in the 
‘start routine’ at 0005 when a jump is made past various sub- 
routines and character tables. 


address Hex. code mnemonic comment 
0005 C3 CB 03 JP 03CB Make a jump. 
03CB 60 LDH,B Jumps to here. 


SUBGROUP B: JUMP INSTRUCTIONS THAT USE INDIRECT 
ADDRESSING 
There are three instructions that enable jumps to be made to indirect 
addressed locations. Surprisingly the register pairs are the HL, IX and lY 
register pairs rather than the usual set of HL, BC and DE register pairs. 
The instructions are: 


mnemonic instruction Hex. 
JP (HL) E9 

JP (IX) DD E9 

JP (IY) FD E9 


The effect of the execution of these instructions is to load the Program 
Counter with the specified address. The flags are not affected. 
An example from the 8K monitor program. 

The 8K monitor program uses the ‘JP (HL)' instruction in its 
‘display routine’ in a very interesting way. In this routine bit 15 of the 
HL register pair is Set, (by using a SET 7,H instruction) and then a 

_ jump is made to this location. In reality such a jump will take the Z80 
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out of the monitor program but because of a special ‘switch’ in the 
circuitry of the ZX-81 the Z80 will start executing NOP instructions 
until an ‘interrupt’ occurs. This ‘interrupt’ will always occur after 32 
NOP instructions as this is the length of a display line. 


address Hex. code mnemonic comment 
0044 E9 JP (HL) Start executing 
NOP’s. 


SUBGROUP C: THE RELATIVE JUMP INSTRUCTION. 

The single instruction in this subgroup, the ‘JR e’ instruction allows the 
programmer to make jumps to locations that are within 127 locations 
forward and 128 locations back from the current position. 

The ‘JR e’ instruction is a very useful instruction as it allows the 
programmer to make short jumps using just two bytes of code, whereas a 
‘JP addr.’ instruction uses three bytes of code. 

The following diagram shows how the different values of ‘e’ are used to 
specify jumps of varying length. The value of ‘e’ is always considered to 


be in 2’s complement arithmetic. ‘e' values Hex. 





TOP 
7F ‘e’ value of 7F is the 
aa 7E maximum forward jump. 
01 
00 
FF 
FE 
FD 
. 81 
jumps 80.0—s« ‘value of 80 is 
backwards maximum backward jump. 
memory holding machine 
code program 
Diagram 8: To show how different values of ‘e’ cause jumps to 
different locations. 


All programmers use their own ‘rules of thumb’ for calculating the 
required values of ‘e’ when they are writing machine code. The author 
considers that for forward jumps the value of ‘e’ represents the number of 
bytes that are ‘jumped over’. Whereas the more difficult backwards 
jumps are obtained by counting backwards, in Hex., the ‘e’ location being 
called ‘FF’, until the required location has been reached. The Hex. value 
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assigned to this location is then the correct value for ‘e’. 


The instruction is: 


mnemonic instruction Hex. 
JRe 18e 


In the monitor program the ‘JR e’ instruction is used many times. The 
following example comes from the ‘error handling routine’: 


An example from the 8K monitor program. 

The ‘error handling routine’ begins at 0008 but it then has to jump 
past some other subroutines. As the required jump is only over 
Hex.46 bytes of code a ‘UR e’ instruction can be used. 


address Hex.code mnemonic comment 

OGGE 18 46 JR @056 Jump past 
Hex.46 bytes 

0056 : and continue 
from location 
0056. 


SUBGROUP D: JUMP INSTRUCTIONS CONDITIONAL ON THE 
CARRY FLAG. 

There are four instructions that allow the programmer to make jumps 
that are conditional on the state of the Carry flag. These instructions are 
equivalent to the BASIC lines; 

IF C THEN GOTO.... 
and 
IF NOT C THEN GOTO..... 

Two of the instructions allow for absolute addressed jumps, whilst the 
other two instructions allow for relative jumps. 

lt is sensible at this point to describe the Carry flag in detail before 
proceeding further. 


The Carry Flag: 

This flag is bit @ of the flag register and has already been 
mentioned because of its use in arithmetic operations. 

The following statements can be made concerning the Carry 
flag: 
i. ALL ADD and ADC instructions will Set or Reset the Carry flag, 
depending on whether or not the result overflows the space allowed 
for it. 
ii. All SUB, SBC and CP instructions will Reset the Carry flag if the 
result is ‘correct’, and Set the flag if zero has been passed. 
iii. All AND, OR and XOR operations Reset the Carry flag. 
iv. Rotation instructions (see page 66) affect the Carry flag. 
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v. LD instructions do not affect the Carry flag. 
There are two instructions for handling the Carry flag and they 
are: 


mnemonic instruction Hex. 
SCF 37 
CCF 3F 


The ‘SET CARRY FLAG’ instruction (SCF) simply Sets the Carry 
flag. 

The ‘COMPLEMENT CARRY FLAG’ instruction (CCF) changes 
the value of the Carry flag from 0 to 1, or vice versa. Note that ‘AND 
A’ is the usual instruction for clearing the Carry flag. 

The actual instructions in this subgroup are: 


mnemonic instruction Hex. Comment 

JP NC,addr. D2 addr. Jump on Carry flag 
Reset. 

JP C,addr. DA addr. Jump on Carry flag 
Set. 

JR NC,e 30 e Jump on Carry flag 
Reset. 

JR Cye 38 e Jump on Carry flag 
Set. 


In any machine code program the instructions that allow for jumps to 
be made conditional on the state of the Carry flag are very common. The 
following example from the monitor program shows this type of instruc- 
tion being used three times in a short machine code routine. 


An example from the 8K monitor program. 

In the ‘test PRINT AT parameters routine’ the parameters are 
tested to see that they are in the correct range. The line parameter 
must be less than 22, and the column parameter must be less than 
32. | 

The testing of the parameters is done by the following lines: 


address Hex. code mnemonic comment 
O8F5 9E 17 LD A,+17 Test line 
8F7 90 SUBB parameter 
against hex. 17. 
8F8 38 GB JR C,0905 Error B if fails. 
8FA FD BE 22 CP (4022) Test v. lower 
screen. 
8FD DA 35 08 JP C,0835 Error 5 if fails. 
906 3C INCA Store back 
90 1 47 LD B.A inB. 
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902 3E 1F LD A,+1F Test column 


904 91 SUB C parameter 

| against Hex. 1F. 
905 DA ADGE JP C,@EAD Error B if fails. 
968 C6 G2 ADD A,+@2 Store back in 
9GA 4F LDC.A C. 


The conditional jump instructions are used to make jumps to the 
routines that handle the different errors. 


SUBGROUP E: JUMP INSTRUCTIONS CONDITIONAL ON THE ZERO 
FLAG. 

There are again four instructions that allow the programmer to make 
jumps that are conditional on the state of the Zero flag. These instruc- 
tions are equivalent to the BASIC lines: 

IFZTHENGOTO...... 
and 
IF NOT Z THEN GOTO...... 

Two of the instructions allow for absolute addressed jumps, whilst the 
other two instructions allow for relative jumps. 

It is sensible at this point to describe the Zero flag in detail before 
proceeding further. 


The Zero Flag: 

This flag is bit 6 of the flag register and it is Set if the result of an 
operation is zero, and Reset if otherwise. 

i.e. For operations in which the result is put into the A register, the 
Zero flag will be Set if the A register holds zero, otherwise the Zero 
flag will be Reset. 

The following statements can be made concerning the Zero flag: 
i. ALL ADD, INC, ADC, SUB, DEC, SBC, CP, AND, OR and XOR 
instructions using single registers, and ADC and SBC instructions 
using register pairs, affect the Zero flag. 

lil. Rotation instructions (see page 66) affect the Zero flag. 

ili. Bit testing instructions (see page 69) affect the Zero flag. 

iv. LD instructions (except ‘LD A,I’ and ‘LD A,R’) do not affect the 
Zero flag. 

v. Block searching instructions (See page 72) use the Zero flag. 
vi. There are no instructions for explicitly handling the Zero flag. 


The actual instructions in this subgroup are: 
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mnemonic instruction hex. comment 


JP NZ,addr. C2 addr. Jump on Zero flag 
Reset. 

JP Z,addr CA addr. Jump on Zero flag 
Set. 

JR NZ,e 20e Jump on Zero flag 
Reset. 

JR Z,e 28 e | Jump on Zero flag 
Set. 


Once again the instructions in this subgroup are very common instruc- 
tions. The following example shows the instructions being used in the 
‘PRINT command routine’. 


An example from the 8K monitor program. 

In the ‘PRINT command routine’ the different codes of a BASIC 
line are tested to see whether they are NEWLINE characters, 
commas or semi-colons, keywords or the word ‘AT’. These tests 
are performed by using conditional jump instructions. 

The lines involved are: 


address Hex.code mnemonic comment 
GACF 7E LD A,(HL) Pick-up code. 
ADG FE 76 CP +76 Is it NEWLINE? 
AD2 CA 84 OB JP Z,0B84 Jump if it is. 
AD5 D6 1A SUB +1A Make ‘comma 
AD7 CEGG ADC A,+@G and semi-colon’ 
the same. 
AD9 28 69 JR Z,0B44 Jump if ‘,’ or‘; 
ADB FE A7 CP +A7 Test if ‘AT’. 
ADD 20 1B JRNZ,GAFA Jumpifnot ‘AT’. 
ADF ___........ Proceed with 
‘AT’. 


SUBGROUP F: JUMP INSTRUCTIONS CONDITIONAL ON THE SIGN 
FLAG. 
There are two instructions that allow the programmer to make jumps 
that are conditional on the state of the Sign flag. Both instructions use 
absolute addressing. 
These instructions are equivalent to the BASIC lines: 
IF S>=0 AND S<=127 THENGOTO..... 
and 
IF S>=128 AND S<=255 THENGOTO..... 
It is sensible at this point to describe the Sign flag in detail before 
proceeding further. 
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The Sign Flag: 

The Sign flag is bit 7 of the flag register and it shows whether a 
result is negative or positive with respect to 2’s complement arith- 
metic. As bit 7 of a single register and bit 15 of a register pair are 
sign bits, it follows that the Sign flag is just a copy of the appropriate 
sign bit of a register or register pair. The following statements can 
be made concerning the Sign flag. 

i. All ADD, INC, ADC, SUB, DEC, SBC, CP, AND, OR and XOR 
instructions using single registers, and ADC and SBC instructions 
using register pairs, affect the Sign flag. 

li. Rotation instructions (see page 66) affect the Sign flag. 

ii. LD instructions (except ‘LD A,I’ and ‘LD A,R’) do not affect the 
Sign flag. 

iv. Block searching instructions iséé page 72) use the Sign fiag. 

v. There are no instructions for explicitly handling the Sign flag. 


The actual instructions in this subgroup are: 


mnemonic instruction HexComment 

JP P, addr. F2 addr. Jump if result 
positive. 

JP M,addr. FA addr. Jump if result 
negative 
(minus). 


Both these instructions are rather uncommon and their use can usually 
be avoided. However the ‘JP M,addr.’ instruction can be used to test bit 
6 as in the following example. 


An example from the 8K monitor program. 

In the ‘next variable or BASIC line routine ‘the different classes of 
variables are distinguished from each other by the different config- 
urations of bits 5, 6 and 7. 

The bit 5 is tested using a ‘BIT 5’ instruction (see page 69). 

The bit 7 is tested by ‘doubling’ and looking at the resultant state 
of the Carry flag. 

The bit 6 is tested by ‘doubling’ and then using the ‘JP M,addr.’ 
instruction to test the state of the new bit 7. 

The code for the initial letter of the variable is held in the A 
register, and the following lines perform the test. 


address Hex.code mnemonic comment 
O9FC 87 ADD A,A ‘Double’ 
9FD FA @1 GA JP M,GAG@1 Jump if bit 7 Set. 
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SUBGROUP G: JUMP INSTRUCTIONS CONDITIONAL ON THE 
OVERFLOW/PARITY FLAG. 

There are two instructions that allow the programmer to make jumps 
that are conditional on the state of the Overflow/Parity flag. Both instruc- 
tions use absolute addressing. 

It is sensible at this point to describe the Overflow/Parity flag before 
proceeding further. 


The Overflow/Parity Flag: 

This flag is bit 2 of the flag register and as the name implies itis a 
dual purpose flag. Certain groups of instructions use the flag to 
denote ‘overflow’ whilst other groups of instructions use the flag to 
store the result of a ‘parity test’. 

The concept of ‘overflow’ does not relate to there being insuffi- 
cient room, as is tested by the Carry flag, but rather to the test as to 
whether the result of an operation in 2’s complement arithmetic is 
giving a correct or incorrect answer. 

e.g. Consider: Hex. 14 ADD Hex. 6F where the result will be 
Hex. 83. This result is correct when dealing with absolute binary 
arithmetic, but it is incorrect in 2's complement arithmetic. 

The decimal interpretation of this operation shows the error 
condition clearly. 

Hex. 14 + 6F = 83 INCORRECT 
Decimal 20 + 111 = -125 INCORRECT 

This operation will therefore SET the Overflow/Parity flag. 

Overflow can also occur in subtraction operations. Consider: 
Hex. 83 -6F = 14 INCORRECT 
Decimal —-125 — 111 = 20 INCORRECT 
when the Overflow/Parity flag will again be Set. The concept of 
‘parity’ refers to the testing of the bits in a byte to determine whether 
there is an even, or odd, number of bits Set. 

e.g. Consider the byte: 01010101 in which there is an even 
number of bits which are Set. (4). Therefore the Overflow/Parity 
flag will be SET. 

Consider next the byte: 10101110 in which there is an odd 
number of bits which are Set. (5). Therefore the Overflow/Parity 
flag will be RESET. 

The following statements can be made concerning the Overflow/ 
Parity flag. 

i. All ADD, ADC, SUB, SBC and CP operations are tested for 
‘overflow’. 


li. All AND, OR and XOR operations are tested for ‘parity’. 


57 


il. The results of Rotation operations are tested for ‘parity’ (see 
page 66). 


iv. The INC instruction will Set the flag if the result is Hex.80. 


v. The DEC instruction will SET the flag if the result is Hex.7F. 


vi. The block instructions (see page 72) use the Overflow/Parity 
flag. 


vii. There are no instructions for explicitly handling the Overflow/ 
Parity flag. 


The actual instructions in this subgroup are: 


mnemonic instruction Hex. Comment 

JP P@,addr. 2 addr. Jump if parity 
odd, or no 
overflow. (flag 
Reset) 

JP PE,addr. EA addr. Jump if parity 
even, or 
overflow. (flag 
Set) 


The two instructions are both rarely used instructions except when 


Parity’ is being tested. But in the ZX-81 system there is no parity check 
on incoming or outgoing data. 


The following example shows the flag being used to test for ‘overflow’. 


An example from the 8K monitor program. 

In the ‘character code sorting routine’ the different types of 
character codes have to be separated. The codes for the simple 
characters are in the range Hex.@@ — 3F, whereas the codes for the 
editing commands are in the range Hex.7@ — 79. 
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The different types are separated using a ‘JP PE,addr.’ 
instruction. 


The lines are: 
address Hex.code mnemonic comment 
@515 7E LD A,(HL) Pick-up code. 
516 FE F@ CP +F@ Compare it to 
+FG@ 
518 EA 2D 65 JPPE,@52D Jumpon 
rflow. 
51B..... proceed with simple characters. seal 


The routine works by comparing the character code, that it has 
collected from the main character table, to the constant Hex. FO. All 
the codes for simple characters will lead to there being ‘no over- 
flow’. e.g. The letter ‘Z’ with code. Hex. 3F will give: 
3F -FO = 4F 


or in decimal, 63 -(-16) = 79 

which is CORRECT and Resets the flag. 
The codes for the editing commands will however give ‘overflow’. 
e.g. The code for RUBOUT is Hex.77, and 

77-F@ = 87 

or in decimal 119 ~(-16) = -121 

which is INCORRECT and Sets the flag, and thereby leads to the 

Jump occurring. 


The BASIC programs that demonstrate these instructions are to be 
found on page 97. 


Group 11: The ‘DJNZ e’ instruction. 
This single instruction is one of the most useful instructions in the Z80 
instruction set. 


The ‘DJNZ e’ instruction is an instruction that Decrements the B 
register and does a relative Jump if the resultant value in the B register is 
Not Zero. The instruction has many similarities to the BASIC command 


NEXT. 


In a BASIC program the FOR command is used to set up a loop 
variable and the NEXT command delimits the working part of the loop. 
When a ‘DJNZ e’ instruction is used, the B register becomes the loop 
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variable and the ‘DJNZ e’ instruction is itself used as the equivalent of the 
NEXT command. 
The following example shows these similarities: 


BASIC program Machine Code language program 

FOR |=10 TO 1 STEP —1 loop variable LD B,+10 
initialised. 

LET is the working LD... 

LET 25 part. LD... 

NEXT | the delimiter. DJNZ e 


Note how the loop in the example uses ‘STEP -1’, this is because the 
‘DJNZ e' instruction is always a Decrementing instruction. 

It is also important to note that the value of ‘e’ is the displacement value 
that will take the ‘loop’ back to the start of the ‘working part’ of the 
program. Interestingly it is a common mistake to ‘jump back’ to the loop 
variable and hence create an endless machine code loop. 

The above example shows the normal use of the ‘DJNZ e’ instruction, 
but it is also possible to use it with ‘forward jumps’ but that is indeed 
‘complicated programming’ and perhaps is best avoided. 

The actual instruction is: 


mnemonic instruction Hex. 
DJNZ e 10e 


This instruction is very commonly used and the following example from 
the ‘initialisation routine’ is just one of many possible examples. 


An example from the 8K monitor program. 

When the ZX-81 is switched on, the ‘initialisation routine’ has to 
construct a display file that consists of 25 NEWLINE characters. 
(Hex.76, decimal 118). This operation is performed using a ‘DJNZ e’ 
instruction. 

Initially the HL register pair holds the current D-FILE and then the 
B register is loaded with the loop variable Hex.19, decimal 25. 

The working part of the loop consists of a ‘LD (HL),+ 76’ instruc- 
tion, that enters the NEWLINE character and a ‘INC HL’ that moves 
the pointer forward one location. 

The ‘DJNZ e’ instruction is then used to decrement the B register 
and jump back to repeat the ‘working part’ if the loop variable is not 
zero. 

The lines involved are as follows: 


address Hex. code Label mnemonic comment 

0406 0619 LD B,-19 Loop variable. 
408 36 76 W-Part LD (HL),+76 NEWLINE 
40A 23 INC HL Forward one. 


40B 10 FB DJNZ W-Part Back to ‘W-Part’ 
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Note in the above lines how a ‘Label’ field has been used to mark 
the start of the working part with the label ‘W-Part’, and how the 
mnemonic for the ‘DJNZ e’ instruction has been written as ‘DJNZ 
W-Part’. The use of labels will be found frequently from now on. 

Note also how the value of ‘e’ is given as Hex.FB in location 
@46C. The author finds that the best way of checking that this value 
of ‘e’ is correct, is to count back from @4@6C. The location @4¢B 
being equivalent to ‘FC’, the location 040A being equivalent to ‘FD’, 
and so on until the start of the correct loop will have the value ‘FF’. In 
the exampie the value of ‘e’ being ‘FB’ is correct as it loops back to 
the start of the instruction line labelled W-Part. 

A BASIC program that demonstrates the ‘DJNZ e’ instruction is to be 
found on page 99. 


Group 12: The ‘Stack’ instructions. 

The stack is used extensively in most machine code programs and 

therefore there are many instructions for handling the data on the stack. 
The instructions can be divided into two subgroups. The first subgroup 

contains the instructions that can be used by the programmer to handle 

data that is stored temporarily on the stack. The second group of instruc- 

tions contains those instructions that use the stack themselves. 


SUBGROUP A: THE PUSH AND POP INSTRUCTIONS. 

These instructions allow the programmer to put, ‘PUSH’, two bytes of 
data on to the stack, and to remove, ‘POP’, two bytes of data off the stack. 

The two bytes of data in a PUSH operation must be copied from a 
specified register pair, and in a POP operation must be copied into a 
specified register pair. 

When a PUSH operation is performed the Stack Pointer is first de- 
cremented, a copy of the high register byte is made and stored in the 
location addressed by the Stack Pointer. Then the Stack Pointer is 
decremented a second time and a copy of the low register byte is made 
and this byte is likewise stored in the location addressed by the Stack 
Pointer. The opposite actions are taken during a POP operation. 

The actual instructions in this subgroup are: 


mnemonic instruction Hex. mnemonic instruction Hex. 
PUSH AF F5 POP AF F{ 
PUSH HL E5 POP HL F1 
PUSH BC C5 POP BC C1 
PUSH DE D5 POP DE D1 
PUSH IX DD E5 POP IX DD E1 
PUSH IY FD E5 POP IY FD E1 


It is important to realise that when two bytes are PUSHed on to the 
Stack, that no record is kept in any way that shows where the data 
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came from. Two bytes coming from the HL register pair may therefore 
be POPed into the BC register pair or indeed any register pair. 

The storing of data on the stack as a temporary measure is 
illustrated in the following example. 


An example from the 8K monitor program. 

In the ‘display routine’ the current values held in the four main 
register pairs are saved on the stack, when ‘slow mode’ interrupts 
the normal execution of a program. Later the contents of the 
registers are restored. 

Note how the ‘saving’ is done in a certain order, and how the 
‘restoring’ is done in the reverse order so as to get the correct 
contents restored. 


address Hex.code Label mnemonic comment 

6220 F5 Saving PUSHAF  Savecopies of 
221 C5 PUSH BC the main 
222 D5 PUSH DE _ register pairs 
223 E5 PUSH HL = onthe stack. 

G2A4 E1 Restoring POP HL Restore the 
2A5 D1 POP DE contents of the 
2A6 C1 POP BC main register 
2A7 F1 POP AF pairs. 


SUBGROUP B: THE CALL, RET AND RST INSTRUCTIONS. 

The execution of all these instructions results in either addresses 
being put on the stack, or return addresses being removed from the 
stack. 

The CALL and the RST instructions are directly equivalent to the 
BASIC ‘GOSUB’ command, and the RET instructions are equivalent to 
the ‘RETURN’ command. There are however several conditional CALL 
and RET instructions that have no direct equivalent in BASIC. 

Each of these three subgroups will now be discussed in turn. 


SUBGROUP A: THE CALL INSTRUCTIONS. 

The CALL instructions are used to enter subroutines, therefore the 
return address has to be saved. This is done by the high byte of the 
Program Counter being copied and saved on the stack and then the low 
byte being copied and saved. The Stack Pointer is decremented before 
each byte is stored. The Program Counter ‘is then loaded with copies of 
the two bytes of data that follow the CALL instruction proper. As usual the 
low byte is the first of these bytes of data and the high byte the second 
byte of data. 
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There are instructions that allow for the execution of subroutines to be 
made conditional on both states of the four major flags. 
The actual instructions in this subgroup are: 


mnemonic instruction Hex. Comment 
CALL addr. CD addr. Unconditional 

GOSUB. 
CALL C,addr. DC addr. GOSUB, 

Carry flag Set. 
CALL NC,addr. D4 addr. GOSUB, 

Carry flag Reset. 
CALL Z,addr CC addr. GOSUB, 

Zero flag Set. 
CALL NZ,addr. C4 addr. GOSUB 

Zero flag Reset. 
CALL M,addr. FC addr. GOSUB, 

Sign flag Set. 
CALL P, addr. F4 addr. GOSUB, 

Sign flag Reset. 
CALL PE, addr. EC addr. GOSUB, O’P flag Set. 
CALL PO, addr. E4 addr. GOSUB, 

O/P flag Reset. 


In any large machine code program there will be a large number of 
subroutines and hence CALL instructions are fairly common instructions. 
However conditional CALL instructions are always fairly uncommon. 

The following example shows an interesting feature of the ZX-81 
system. 


An example from the 8K monitor program. 

In a ZX-81 system that has less than 34K of available RAM the 
display file is ‘collapsed’. That is to say that an empty display line 
will consist of only a NEWLINE character, and partially completed 
lines will have a NEWLINE character positioned after the last 
defined character of the line. 

In a ZX-81 system with more than 3V4K the display file is usually 
fully defined, with 24 lines of 32 characters. 

In the ‘build up an edit line routine’ it is necessary to test for the 
size of available RAM so that the display file can be expanded to 
hold the edit line, if necessary. 

The actual lines involved are: 


address Hex.code mnemonic comment 
04B7 3A 05 40 LDA,(4005)  Highbyte of 
RAMTOP 
4BA FE 4D CP +4D Test for 34K of 
RAM 
4BC DC 5DGA CALLC,@A5D GOSUB if less 


63 RAM. 


SUBGROUP B: THE RST INSTRUCTIONS. 

In the Z80 instruction set there are eight RST instructions. These 
instructions are in effect CALL instructions but the address of the sub- 
routine does not have to be specified as it is predetermined. 

e.g. The instruction C7 which has the mnemonic ‘RST 0000 is a single 
byte instruction that has the predetermined address of @@0@. The in- 
struction performs in just one byte the operation that would take three 
bytes using a ‘CALL addr.’ instruction. 

The eight RST instructions all have predetermined addresses that are 
in the range 6G@00-0038. 

The actual instructions are: 


mnemonic instruction Hex. comment 

RST 6000 C7 ‘GOSUB 6660’ 
RST 00G8 CF ‘GOSUB 6668’ 
RST 0016 D7 ‘GOSUB G4 10’ 
RST 0018 DF ‘GOSUB 0618’ 
RST 8020 E7 ‘GOSUB 6620’ 
RST 9028 EF ‘GOSUB 0628’ 
RST 0630 F7 ‘GOSUB 6630’ 
RST 0038 FF ‘GOSUB 6638’ 


In a Z80 machine code language program that is started at location 
QGQ@ it is therefore a normal feature to find that there are several 
commonly used subroutines starting at these predetermined addresses. 
The 8K monitor program is typical in this matter and the following list 
shows the routines called by the different RST instructions. 


RST Routine 

0d0G Start routine. 

0008 Error handling routine. 

001 Print character routine. 

0018 Collect present character routine. 
0620 Collect next character routine. © 
0028 Calculator routine. 

GG30 Make room in memory routine. 
0638 Display interrupt routine. 


The following example shows how the ‘print character routine’ is called 
by using ‘RST 6010’. 
An example from the 8K monitor program. 
The following extract from the ‘print keyword routine’ shows that 
the code of the character to be printed has to be present in the A 
register before the ‘RST @@1@' instruction can be used. 
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address 
0957 
958 


959 


95A 
95C 


Hex. code 
AF 
D7 


GA 


E6 3F 
D7 


mnemonic comment 
XORA Zero A register. 
RST 0016 Print a zero — 
a space. 
LD A,(BC) Pick-up 
character. 
AND +3F mask character. 
RST 0016 Print the 
character 


SUBGROUP C: THE RET INSTRUCTIONS 

This subgroup consists of a simple RET instruction and eight condi- 
tional instructions. The main use of all these instructions is to act as an 
end marker of a subroutine and cause a return to the main program. 

It is important to realise that a RET instruction does no more than take 
a return address from the stack and put it into the Program Counter. The 
first byte copied from the stack forms the low byte of the Program 
Counter and the second byte forms the high byte of the Program 
Counter. The Stack Pointer is incremented twice during any RET 


instruction. 


The actual instructions are: 


mnemonic 


RET 
RET C 


RET NC 


RET Z 
RET NZ 


RET M 
RET P 


RET PE 
RET PO 


instruction Hex. 


C9 
D8 


D@ 


C8 
C@ 


F8 
FO 


E8 
EG 


comment 

The simple RETURN. 
RETURN if Carry flag 
Set. 


RETURN if Carry flag 
Reset. 

RETURN if Zero flag Set. 
RETURN if Zero flag 
Reset. 

RETURN if Sign flag Set. 
RETURN if Sign flag 
Reset. 

RETURN if O/P flag Set. 
RETURN if O/P flag 
Reset. 


It is an important point in machine code programming to appreciate 
that a return address that is taken off the stack by a RET instruction, was 
not necessarily put on the stack by a corresponding CALL instruction. 

The following example shows how a table of addresses is handled so 
that a ‘jump’ can be made to a required address read from the table. 


An example from the 8K monitor program. 

In the ‘BASIC line scanning routine’ the different BASIC com- 
mands are allocated to one of seven command classes. Therefore 
when a certain command is being dealt with, the class number is 
determined and a ‘jump’ is made to the appropriate command class 
routine. The command class numbers are @—6, and at @D16 to 
@DIC is a table of displacements values. The following routine is 
used to access the table, and a RET instruction is used to ‘jump’ to 
the required address. 

Initially the class number is present in the C register. 


address Hex.code mnemonic comment 

@DG5 21120D LDHL,+@D16 Base address. 
DO8 G6 GG LD B,+00 Clear B. 

DGA Q9 ADD HL,BC Form address. 

DGB 4E LD C,(HL) Pick-up value. 

DOC 09 ADD HL,BC Form new 
address. 

D@D E5 PUSH HL Put in on stack. 

DGE DF RST 0G18 Collect next 
value. 

DOF C9 RET ‘Jump’ to 
address. 

The Command Class Address Table. 

@D16 17 gives address @D2D Class @ 
D17 25 gives address @@DC Class 1 
D18 53 gives address @@DB Class 2 
D19 OF gives address @D28Class3 
D1A 6B gives address @D85 Class 4 
D1B 13 gives address @D2E Class 5 
D1C 76 gives address @D92 Class 6 


The BASIC programs that demonstrate these instructions are to be 
found on page 100. 


Group 13: The Rotation Instructions. 

in the Z80 instruction set there are many instructions that allow the 
programmer to rotate the bits in a specified byte. 

These instructions can prove to be very useful, especially as rotating a 
byte to the ‘left’ has the effect of doubling the value, and rotating a byte to 
the ‘right’ has the effect of halving the value. 

All of the instructions use and affect the Carry flag in some way, and in 
some instances itis best considered a ‘bit8’ and at other times asa‘bit-1.. 
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The different types of rotation are best shown diagrammatically and 
the following diagram shows the direction of the rotation and the position 
of the Carry flag for each type of rotation. 


RLC & a Bit 7 goes to Carry. 
Rotate left ie Teseseaeaeeteo 3¢2¢1¢0 Bit 7 goes to 0. 
with Carry. 


RL & RLA Bit 7 goes to Carry. 
Rotate chil arenes é = 7e | eeesedearzeo 1€0 Carry goes to Bit O. 
left. 
SLA | rerseteoten Bit 0 is Reset. 
Shift on | o C fc |< | rerseteoten 0 Bit 7 goes to Carry. 


Ree BEC SS ee eee 

Rotate right Hele 0 goes to Carry. 

with Carry. | 7465 a4s329100 695 0493929190 aT] Bit 0 goes to Bit 7. 
RR&RRA i ON 


i Bit 0 goes to Carry. 
ence a8 e542 100 #190 -? [reesacseno frfe] Bl canpaces to Bit 7 
SRA Bit 0 goes to Carry. 

Shift right. 7 6959493424140 ? Bit 7 5 anchanged. 


SRL 


Logical shift O- 74 6254443320140 > Bit 0 goes to Carry. 
right. Bit 7 is Reset. 


ee aes ia 
RLD Aregister 


| 7654 [7ese 
The two 


special ‘nibbie’ 
ae eh 2 handling 


~ — 


\ ‘(HL)’ . instructions. 
RRD errs vy 


—_ 


“a. — a 
— ere ee 


Diagram 9. The Different Types of ‘ROTATION’. 
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The actual instructions are as shown in the table: 


Byte 
A 


H 
L 
B 
C 
D 
E 
(HL) 
(IX+d) 
(1¥+d) 


RRD 
RLD 


RLC 
07 
(RLCA) 
or 
CB 07 
CB 04 
CB@5 
CB OO 
CB O1 
CB G2 
CB O63 
CB G6 
DD CB 
d@6 
FD CB 
d@6 
ED 67 
ED 6F 


RL 
17 
(RLA) 
or 
CB17 
CB14 
CB15 
CB 10 
CB 11 
CB 12 
CB 13 
CB 16 
DD CB 
d16 
FD CB 
d 16 


SLA 


CB 27 
CB 24 
CB 25 
CB 20 
CB 21 
CB 22 
CB 23 
CB 26 
DD CB 
d 26 
FD CB 
d 26 


RRC 
OF 


RR 
1F 


(RRCA) (RRA) 


or 
CB OF 
CBGC 
CB@D 
CB G8 
CB 69 
CBGA 
CB@B 
CBGE 
DD CB 
dGE 
FD CB 
dGE 


or 

CB 1F 
CB 1C 
CB 1D 
CB 18 
CB 19 
CB 1A 
CB 1B 
CB 1E 
DD CB 
d1E 
FD CB 
d1E 


SRA 


CB 2F 
CB 2C 
CB 2D 
CB 28 
CB 29 
CB 2A 
CB 2B 
CB 2E 
DD CB 
d2E 
FD CB 
d2E 


SRL 


CB 3F 
CB 3C 
CB 3D 
CB 38 
CB 39 
CB 3A 
CB 3B 
CB 3E 
DD CB 
d3E 
FD CB 
d3E 


Note that there are four single byte instructions for rotating the A 
register. 

The following statements can be made about the way the rotation 
instructions affect the flags. 
i. All the instructions, except ‘RLD' and ‘RRD' affect the Carry flag. 
li. All the two byte instructions affect the Zero flag. The flag being Set if the 
resultant byte is zero. 
iii. All the two byte instructions affect the O/P flag. The flag being Set if 
the parity of the result is even. 
iv. All the two byte instructions affect the Sign flag. The flag copies the 
sign bit of the resultant byte. 
v. The four single byte instructions affect the Carry flag but leave the 
other flags unchanged. 

There are many different ways in which rotation instructions can prove 
to be useful. The following example shows the ‘RL E’ instruction being 
used. 


An example from the 8K monitor program. 

In the ‘SAVE command routine’ the program name, and then the 
program and variables are passed to the cassette output in the 
following way: 

Each byte in turn is loaded into the E register. The Carry flag is 
Set and the E register rotated left. Bit @ is thereby Set, and the 
former bit 7 has been moved to the Carry flag. Bit @, at this stage, is 
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a ‘marker’. The routine then sends signals to the cassette output 

that differ depending on whether the Carry flag is Set or Reset. 

The Carry flag is then cleared and a jump is made back to the ‘RL E’ 
instruction. 

Thereby each of the 8 bits of the E register are pushed into the 
Carry flag in turn. The Zero flag is used to count out the 8 bits as it 
will be Set when the ‘marker’ bit is rotated into the Carry flag. 


The actual lines are: 


address Hex.code mnemonic comment 
O3IE 5E LD E,(HL) Pick-up a byte. 
SIF 37 SCF SET the Carry 
flag, ‘marker’. 
320 CB 13 RLE Rotate E. 
322 C8 RET Z RETURN after 8 
loops. 
eee Differing outputs 
i dorset for Carry Set 
nnd Goevand or Reset. 
33B A7 AND A Clear Carry. 
33C 10 FD DJNZ @33B A timing delay. 
33E 18 E@ JR 0326 Repeat the loop. 


(see page 150 for the full ‘SAVE’ command routine) 


A BASIC program that demonstrates the rotation instructions is to be 
found on page 103. 


Group 14: The ‘Bit handling’ instructions. 
The instructions in this group allow the programmer to test for the state 
ofa Specified bit, to Reset a specified bit or to Set a specified bit. 

Once again the group will be divided into three subgroups. 


SUBGROUP A: THE BIT INSTRUCTIONS 

These instructions are used to test a specified bit. The result of the test 
goes to the Zero flag. The flag is SET if the bit tested is RESET, that is 
holds value zero. The Zero flag is RESET if the bit tested is SET, that is 
holds value 1. 

The actual instruction codes are shown in the following table. 
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bit bit bit bit bit bit bit 
0.861 2 3 4 5 6 


A register RES 87 8F 97 9F A7 AF B7 

CB ** SET C7 CF D7 DF E7 EF F7 

BIT 47 4F 57 5F 67 6F 77 

H register RES 84 8C 94 9C A4 AC B4 

CB** SET C4 CC D4 DC E4 EC F4 

BIT 44 4C 54 5C 64 6C 74 

L register RES 85 8D 95 9D A5 AD B5 

CB** — SET C5 CD D5 DD €5 ED F5 

BIT 45 4D 55 5D 65 6D 75 

B register RES 80 88 90 98 A@ A8 B@ 

CB** SET C@ C8 DG D8 EO E8 FO 

BIT 40 48 50 58 66 68 76 

C register RES 81 89 91 99 Ai AQ BI 

CB** SET Ci C9 D1 D9 E1 E9 F1 

BIT 41 49 51 59 61 69 71 

-D register RES 82 8A 92 QA A2 AA B2 

CB** . SET C2 CA D2 DA E2 EA F2 

BIT 42 4A 52 5A 62 6A 72 

E register RES 83 8B 93 9B A3 AB B3 

CB** SET C3 CB D3 DB E38 EB F3 

BIT 43 4B 53 5B 63 6B 73 

(HL) RES 86 8E 96 9E A6 AE B6 

CB** SET C6 CE D6 DE E6 EE F6 

BIT 46 4E 56 5E 66 6E 76 

indexed RES 86 8E 96 9E A6 AE B6 
(IX +d) 

DD CB d** SET C6 CE D6 DE E6 EE F6 
(1Y +d) 

FD CB d** BIT 46 4E 56 5E 66 6E 76 


Note that all the instructions are preceded by ‘CB’, and the instructions 
for indexed addressed bytes are in addition prefixed by ‘DD’ or ‘FD’. 

The use of the BIT instructions is interesting as it enables the program- 
mer to take advantage of the potential offered to him to save RAM and to 
create rapidly executed programs. 

By using a BIT instruction it is possible to use single bits as ‘flags’. The 
following example shows how this is done. 
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An example from the 8K monitor program. 

The system variable 16385 is composed of 8 different flags. Bit @ 
of this byte is a flag that is used by the ‘PRINT keyword routine’ to 
determine whether or not an extra space is required before a 
keyword. 

e.g. No extra space is required between the line number and the 
first command in the line 10 IF A THEN GOTO B but an extra space 
is required between the ‘A’ and the ‘THEN’. 

The space between the line number and the first command is 
always present, but the space between the ‘A’ and the ‘THEN’ is an 
extra space that precedes the keyword. 

The following lines show the flag being tested. 


address Hex. code mnemonic comment 
0951 FDCB@140 BIT@,(4001) Test the flag. 
955 26 G2 JRNZ,@959 Jump if needed. 
957 AF XORA Clear A. 
958 D7 RST 0010 PRINT a space. 


959........ proceed to print a keyword. 
The extra space is printed if the Bit @ of 16385 is originally RESET, 
as this leads to the Zero flag being SET and the jump not being made. 


SUBGROUP B: THE RES INSTRUCTIONS. 
The RES instructions allow the programmer to RESET a specified bit. 
If the bit however is already in the RESET state then the effect of the 
execution of a RES instruction will do nothing except reaffirm the 
situation. 
The actual instructions are given in the previous table. 
The RES instructions are predominantly used to give a RESET value 
to a flag. 
The following example shows how the ‘FAST command routine’ uses 
a RES instruction. 
An example from the 8K monitor program. 
In the ZX-81 system bits 6 and 7 of system variable 16443, 
CDFLAG, control the operation of the ‘slow’ and ‘fast’ modes. 
When the ‘FAST command routine’ is called, both bit 6 and bit 7 
have to be Reset. 
The following lines show this being done. 


address Hex. code mnemonic comment 

GF26 CDE7@2 CALL 62E7 GOSUB @62E7 
F23 FOCB3BB6 RES6,(403B) Reset bit 6. 
F27 C9 RET Finished. 

Q2E7 FDCB3B7E BIT 7,(403B) ‘Test bit 7. 
2EB C8 RETZ | Already ‘fast’. 


enpeeoeottasetcseeseeoonnewaesase 
. 
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2EF FDCB3BBE RES/7,(403B) Reset bit 7. 
2F3 Cg RET Return. 


SUBGROUP C: THE SET INSTRUCTIONS. 

The SET instructions allow the programmer to SET a specified bit. If 
the bit is already SET then the effect of the execution of the SET 
instruction will do nothing except reaffirm the situation. 

The actual instructions are given in the previous table. 

The SET instructions are predominantly used to give a SET value to a 
bit. 

The following example shows how the ‘SLOW command routine’ uses 
a SET instruction. 

An example from the 8K monitor program. 

The entry into the ‘slow’ mode of operation depends on giving a 
Set value to the bit 6 of the system variable 16443, CDFLAG. _ 

In the ‘SLOW command routine’ this bit is Set and then a jump is 
made to the display routine so that a display is produced. If the 
system was previously in ‘fast’ mode then the production of a 
display will be seen to terminate the ‘fast’ mode. If the system was 
in ‘slow’ mode then there will be no detectable change. 


The lines are: 
address Hex. code 
QOF28 FOCB3BF6 SET6,(403B) Set flagin 
CDFLAG. 
F2C C3 07 02 JP 6207 Produce a 
display. 


The BASIC program that demonstrates these instructions is to be 
found on page 104. | 


Group 15: Block Transferring Instructions and Block Searching 
Instructions. 

The Z80 instruction set contains some very useful instructions that allow 
the programmer to move blocks of memory or to search blocks of 
memory. 

In order to use the block moving instructions the base address of the 
block must be in the HL register pair, the address of the destination of the 
block must be in the DE register pair and the size of the block must be 
held by the BC register pair. 

In order to search a block of memory for the first occurrence of a 
particular value the base address of the block must be in the HL register 
pair, the size of the block in the BC register pair and the A register must 
contain the ‘particular value’. 

The instructions in the group can be further divided into those that are 
‘automatic’ and those that are ‘non-automatic’. 
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The automatic instructions are so called because a block is moved, or 
searched, directly the instruction is executed. Therefore only a single 
instruction is required to move, or search, a block. 

The non-automatic instructions only move, or search, one byte for 
every occasion that the instruction is executed. These instructions there- 
fore require the programmer to create a loop round the instruction if a 
number of bytes is to be moved, or searched. 

The actual instructions are: 


Automatic 

mnemonic instruction Hex comment 

LDIR ED B@ Block moving — incrementing. 
LDDR © ED B8 Block moving — decrementing. 
DPIR ED B1 Block searching — incrementing. 
CPDR ED B9 Block searching — decrementing. 


Non-automatic 
mnemonic instruction Hex comment 


LD! ED A@ Byte moving — incrementing. 
LDD ED A8 Byte moving ~ decrementing. 
CPI ED A1 Byte comparing — incrementing. 
CPD ED AQ Byte comparing — decrementing. 


Each instruction will now be discussed in turn. 

LDIR: This instruction moves a byte from ‘(HL)’ to ‘(DE)’. The values of 
HL and DE are then incremented and the counter BC is decremented. 
When the value of BC reaches zero the moving of bytes stops. The O/P 
flag will have the Reset value. This instruction can therefore move blocks 
of data that contain 1-65536 bytes. 

LDDR: This instruction is similar to the LDIR instruction except that the 
values of HL and DE are decremented after each byte is moved. 

CPIR: This instruction will automatically search a specified block of 
memory for the first occurrence of a byte identical to that held in the A 
register. As each byte is compared the HL register pair is incremented 
and the BC register pair is decremented. 

If a first occurrence is found the search operation stops. The Sign flag 
is Reset, the Zero flag is Set and the program proceeds with the HL 
register pair holding the address of the location that follows the location 
holding the matching byte. 

lf there are no matching bytes in the whole of the block then the BC 
register pair will hold zero, the Sign flag is Reset and the O/P flag is 
Reset. The program then proceeds to the next instruction. 

CPDR: This instruction is similar to CPIR except that the HL register 
pair is decremented before each comparison. 

LDI: The execution of this instruction will move a single byte from ‘(HL)’ 
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to ‘(DE)’, the value of the BC register will be decremented, the value of 
the HL and DE register pairs will be incremented. 

If the value of the BC register pair becomes zero then the O/P flag will 
be Reset, otherwise it will be Set. 

LDD: This instruction is similar to LD! except that the HL and DE 
register pairs are decremented. 

CPI: The execution of this instruction will cause the Zero flag to be Set 
if the byte addressed by the HL register pair matches the contents of the 
A register. If not the Zero flag is Reset. The HL register pair is in- 
cremented and the BC register pair is decremented. The Sign flag is 
always Reset and if the contents of BC become Zero then the O/P flag is 
Reset. 

CPD: This instruction is similar to CPI, except that the HL register pair 
is decremented. 

The use of these instructions is always a little bit complicated, but the 
instructions are very powerful and are therefore very important. 

In the 8K monitor program these instructions are used only occassion- 
ally and the following examples are unfortunately not very straight- 
forward. 

Examples from the 8K monitor program. 


LDDR 

Whenever extra space is required in the program area, the 
variable area or the display file the whole block of data between 
where the space is needed and the STKEND has to be moved up in 
the memory. 

e.g. when an extra simple variable is added to the end of the 
variable area, the block of data from the byte holding Hex. 80 to the 
STKEND has to be moved up 6 locations so as to allow room for the 
new variabie. 

The following lines from the ‘make space in memory routine’ 
shows the ‘LDDR’ instruction being used to perform the moving of 
the biock of data. initially BC holds the size of the space to be added 
but after the ‘change all pointers’ routine the BC register pair holds 
the size of the block. 

Before the ‘LDDR’ is executed the DE register pair will hold the 
address of the ‘new STKEND’ and the HL register pair will hoid the 
address of the ‘old STKEND’. 


address Hex. code mnemonic comment 
G9A3 CD AD @9 CALL @S9AD ‘Change all 
pointers’. 
9A6 2A 1C 40 LD HL,(401C) ‘New STKEND’. 
9A9 EB EX DE,HL Exchange values. 
9AA ED B8 LDDR Move the block. 
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LDI 

The system variable 16419, S-TOP, holds the line number of the 
top line of a display listing. The location 16419 holding the ‘low byte’ 
of the line number and the location 1642@ holds the ‘high byte’. 

However in the program area the line numbers are held with the 
high number byte before the low number byte. 

Therefore when a line number, taken from the program area, is 
put into system variable 16419 the bytes have to be switched over. 
This is done using a ‘LDI’ instruction. 

Initially the DE register pair holds the address of the location 
16419, Hex. 4623, and the HL register pair points to the ‘high byte’ 
of a program line number. Then the ‘high byte’ is saved temporarily 
in the A register and the HL register pair incremented to point to the 
‘low byte’ of the program line number. The ‘LDI’ instruction is then 
used to move this ‘low byte’ from ‘(HL)’ to ‘(DE)’. The execution of 
this instruction increments the HL and the DE register pairs. As DE 
now addresses the location 16420 a simple ‘LD (DE),A’ instruction 
can be used to move the ‘high byte’ to its required destination. 

The lines invoived are: 


address Hex. code mnemonic comment 
@44D 7E LD A,(HL) Save ‘low byte’. 
44E 23 INC HL Point to 
‘high byte’. 
44F ED A@ LDI Move ‘high byte’ 
45| 12 LD (DE),A Move ‘low byte’. 
CPIR 


This instruction is used in the ‘D-FILE handling routine’ to find the 
address required by the system variable 16398, DF-CC. This 
System variable holds the address of the location where the next 
character is to be placed in the display file. 

The following lines show how the program goes back through the 
display file looking for NEWLINEs and then when it finds the re- 
quired line, a ‘CPIR’ instruction is used to go forward along the line. 

The contents of the HL register pair is then decremented and 
saved as DF-CC. 


address Hex. code mnemonic comment 
0926 G4 INC B The line number 
required. 
927 2B DEC HL Go back through 
| the display tile, 
byte by byte. 
928 BE CP (HL) A holds Hex.76, 
a NEWLINE. 
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929 — 20FC JRNZG927 = Jump back. 


92B 10 FA DJNZ @927 Each line found. 

92D 23 INC HL Move into line. 

92E ED B1 CPIR - Look for 
NEWLINE. 

936 2B DEC HL Back one. 

931 22 GE 4G LD (400E),HL Save as DF-CC. 


The BASIC programs that demonstrate these instructions are to be 
found on page 105. 


Group 16: The Input and Output Instructions. 

In the Z80 instruction set there is a comprehensive set of instructions that 
allow the programmer to collect data from an outside source (IN) or to 
send data to a peripheral device (OUT). 

In the ZX-81 system the incoming data comes from either the key- 
board or the cassette player, and the outgoing data goes to the ‘logic 
chip’ and hence to the T.V. screen and the cassette player. 

There are simple, non-automatic and automatic instructions for both 
the ‘IN’ and the ‘OUT’ types of instruction. 

In all cases the data that is moved is handled as a single byte of 8 bits. 
In the case of an ‘IN’ instruction the Z80 takes the single byte off the data 
bus and puts it into a specified register. In the case of an ‘OUT instruction 
the Z80 puts a copy of the contents of a specified register onto the data 
bus. 

The Z80 shows that it is executing an ‘IN’ or ‘OUT’ instruction by using 
certain of its control signals, and an external device can read these 
signals and hence prepare to either place a byte of data on the data bus, 
or to read the byte of data presently on the data bus. 

The Z80 also places an address on the address bus whilst it is 
executing an ‘IN’ or an ‘OUT instruction. This address is determined by 
the programmer, and is called the PORT ADDRESS. It is therefore 
possible for the external devices to read this address and to sense which 
PORT, or device is to perform the sending or the receiving of the data. 

In the following tables of the actual instructions the high and low bytes 
of the PORT ADDRESS are also shown. 
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Input or High Low 


mnemonic instruction Hex Output register P.A. P.A. 
INA,(+dd)} DBdd A A dd 
IN A,(C) ED 78 A B C 
IN H,(C) ED 66 H B C 
IN L,(C) ED 68 L B C 
IN B,(C) ED 46 B B C 
IN C,(C) ED 48 C B C 
IN D,(C) ED 50 D B C 
IN E,(C) ED 58 E B C 
INI ED A2 Non-automatic with increment. 
INIR ED B2 Automatic with increment. 

IND ED AA Non-automatic with decrement. 
INDR ED BA Automatic with decrement. 

OUT (+dd),A D3dd A A dd 
OUT (C),A ED 79 A B C 
OUT (C),H ED 61 H B C 
OUT (C),L ED 69 L B C 
OUT (C),B ED 41 B B C 
OUT (C),C ED 49 C B C 
OUT (C),D ED 51 D B C 
OUT (C),E ED 59 E B C 
OUTI ED A3 Non-automatic with increment. 
OUTIR ED B3 Automatic with increment. 

OUTD ED AB Non-automatic with decrement. 
OUTDR ED 8B Automatic with decrement. 


The automatic and non-automatic instructions have been included in 
the tables but they are not used in the ZX-81 system as their use is 
primarily involved with the use of discs. 

Examples from the 8K monitor program. 

dN’ 

The ‘keyboard scanning routine’ gives a very good example of 
how the ‘IN A,(C)’ instruction can be used. | 

In the ZX-81 system the keys of the keyboard are connected to 
the 8 higher lines of the address bus, and the pressing of the 
different keys puts different signals on the 5 lower lines of the data 
bus. 

In order to give a different final value for each key with this 
combination it is necessary to scan the keyboard 8 separate times. 
On each occasion the values on the 8 higher address lines are 
changed. 

These values are changed using a ‘RLC B’ instruction, and the 
counting of the 8 changes is performed by using a ‘marker’ bit. 
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Initially bit @ is the only bit that is Reset, and after 8 rotations it 
enters the Carry flag and thereby causes an ‘exit’ from the loop. 
The lines involved are: 


address Hex. code mnemonic comment 
@2BE @1FEFE LD BC,+FEFE Initialise. 
2C1 ED 78 IN A,(C) tst Input. . 
2C3 F6 1 OR +61 
2C5 F6 E@ OR +E@ 
sissalacnueeitaneneneties develop value 
individual to 
Ee rere each key. 
2D2 CB OG RLCB Rotate. 
2D4 ED 78 IN A,(C) 2nd-8th Input. 
2D6 38 ED JRC,02C5 Back until 8th. 


(see page 153 for the full ‘Keyboard scanning routine’) 
‘OUT’ 

One of the nice features of using the ZX-81 is that a display of 
broad bands is produced when a program is being loaded from the 
cassette player. This ‘echoing’ of the incoming signa! is produced 
by simply adding an ‘OUT (+FF),A’ instruction to the ‘LOAD com- 
mand routine’. 

The lines are: 


address Hex. code mnemonic comment 
0350 3E 7F LD A,+7F Initialise. 
352 DB FE IN A,(+FE) Collect byte. 
354 D3 FF OUT (+FF),A ‘Echo’ the byte. 
Osseo tiaaseaanes diahiceemmnastaviehetuls 


(see page 151 for the full ‘LOAD command routine’) 
The BASIC programs that demonstrate these instructions are to be 
found on page 108. 


Group 17: The ‘Interrupt’ instructions. 

The Z80 is described as being able to be ‘interrupted’. That is to say that 
the microprocessor can be prevented from proceeding with the sequen- 
tial execution of the instructions in a particular program by the occurr- 
ence of an ‘interrupt. 

There are two control lines that go into the Z80 that when ‘active’ will 
stop the microprocessor and force it to deal with the interruption. 

The first of these lines is called ‘NMI or the ‘non-maskable interrupt 
line’. When this line is activated the Z80 will stop following its present 
program, it will save the contents of the Program Counter on the stack to 
be used later as a return address and it will load the Program Counter 
with the address 066. The Z80 will always be interrupted when the NMI 
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line is activated and it will always proceed to execute instructions from 
@@66 onwards. 

In the ZX-81 the production of the display during the ‘slow’ mode uses 
the NMI facility. When a display is required the NMI line is activated and 
the ‘slow mode display routine’ at 0066 is followed. When this routine is 
finished the ‘return address’ is collected from the stack and the original 
program is continued. 7 

The second control line is called ‘INT’ or the ‘maskable interrupt line’. 
The word ‘maskable’ implying that the facility can be turned on and off by 
the programmer. When the power is first connected to the Z80 this 
interrupt is inactive, or ‘disabled’, and it requires the execution of a ‘El’, 
enable interrupt, instruction before the facility is active. There is also a 
‘DI’, disable interrupt, that can be used at anytime to run off the interrupt 
facility. The occurrence of an ‘interrupt’ will also disable the facility. 

There are three programmable modes to the use of the maskable 
interrupt system. ‘Mode O’ requires that an external device puts a data 
byte on the data bus to signify which of the RST addresses is to be put 
into the Program Counter. ‘Mode 1’ simply causes the address 0038 to 
be put into the Program Counter. ‘Mode 2’ is more complicated and 
involves a pointer address being formed by the combination of the 
contents of the | register and the byte placed on the data bus by an 
external device. This address is then used to index into a vector table and 
an address held in the table is the address that goes into the Program 
Counter. 

The programmer can select by using the ‘IM @’, the ‘IM 1’ or the ‘IM 2’ 
instructions whichever type of interrupt he requires. 

The return from an interrupt routine requires a ‘RET’ instruction to be 
executed, but there are two special instructions ‘RETN’ and ‘RETI’ that 
may be used if desired. These special instructions have the effect of 
‘enabling the maskable interrupt’ the moment the return has been 
performed. Therefore if the programmer wishes to ‘RETurn from a Non- 
maskable interrupt’ with the ‘maskable interrupt’ system activated then a 
‘RETN instruction should be used. Likewise a ‘RETurn from a maskable 
Interrupt’ with reactivation of the interrupt facility requires a ‘RET!’ 
instruction rather than a simple ‘RET’. 

The actual instructions are: 


mnemonic instruction Hex. Comment 
El FB Enable — 

maskable interrupts. 
DI F3 Disable — 

maskabie interrupts. 
IM@ ED 46 Mode @ 
IM 1 ED 56 Mode 1 
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IM 2 ED 5E Mode 2 


RETI ED 4D Return from 
maskable interrupt. 
RETN ED 45 Return from non- 


maskable interrupt. 


Examples from the 8K monitor program. 
Throughout the monitor program the maskable interrupt facility is 
used in mode 1. This is specified in the ‘initialising routine’. 


address Hex. code mnemonic comment 
O3F6 ED 56 IM 1 Enter mode 1. 


In the ‘display routine’ the maskable interrupt facility is enabled 
whenever a line of the display is ready to be sent to the T.V. screen. 
The interrupt always occurs at the end of the display line. 


address Hex. code comment 
0043 FB E| Enable interrupt. 
44 EQ JP (HL) Start sending 
characters. 


There are no examples for these instructions in chapter 5. 


Group 18: Miscellaneous Instructions. 
There are four further instructions in the instruction set. 
‘CPL’ 
This instruction allows the programmer to COMPLEMENT the A 
register. 


mnemonic instruction Hex. comment 
CPL 2F Complements A 
register. 


The instruction simply changes all of the bits of the A register to their 
opposite states. The major flags are not affected. 
An example from the 8K monitor program. 
In the ‘clear memory routine’ it is necessary to form the 2’s 
complement of the contents of the BC register pair. This is 
performed by the following lines: 


address Hex. code mnemonic comment 
GA61 78 LDA,B Form 
A62 2F CPL complement 
A63 47 LDB,A for B. 
A64_ 79 LDA,C Form 
A65 2F CPL complement 
A66 4F LDC,A for C. 
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A67 63 INC BC Add the 1 for 
passing zero. 


‘NEG’ 7 
This instruction allows the programmer to form the 2’s complement of 
the A register. 


mnemonic instruction Hex. 
NEG ED 44 2's complement of A 


The ‘NEG’ instruction affects all the flags. The Sign and the Zero flags 
are affected by the state of the result. The Carry flag will be Set if the A 
register holds zero before the operation and the O/P flag will be Set if the 
A register holds Hex.8@ before the operation. 


‘HALT’ 

The ‘HALT’ instruction is an interesting instruction as its execution by 
the Z80 causes the microprocessor to stop executing any further instruc- 
tions until the occurrence of an interrupt. 


mnemonic instruction Hex. 
HALT 76 


It is no coincidence that the code for NEWLINE in the ZX-81 system is 
also Hex. 76. 

When the characters of a line for the display are being taken out of the 
display file the circuitry of the ZX-81 makes the Z80 execute ‘NOP’ 
instructions. However, when a NEWLINE character is reached, the 
circuitry allows the Hex. 76 to pass to the Z80 and be executed as a 
‘HALT instruction. The Z80 then continues to execute ‘NOP’ instructions 
whilst in its ‘HALTed’ state until it is interrupted. The interruption coming 
when the R register has counted out the 32 characters for the line. 

The ‘HALT’ instruction is also used in the ‘slow mode display routine’. 
This routine is itself the NMI interrupt routine and the ‘HALT’ instruction 
forms part of the timing sequence for the ‘slow’ mode. 

‘DAA’ 

This last instruction is a specialised instruction that allows the pro- 

grammer to ‘Decimally Adjust the A register’. 


mnemonic instruction Hex. 
DAA 27 


In ‘binary coded decimal arithmetic’ (BCD) the decimal digits @-9 are 
represented by the binary 6000 - 1001. 
Therefore 
the byte 600 G0G0 represents decimal @ 
the byte 6011 1001 represents decimal 39 and 
the byte 1000 1000 represents decimal 88 etc. 
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A byte containing a ‘nibble’ (4 bits) of more than 1001 is just not 
allowed. 

The ‘Decimal Adjust the A register’ simply converts bytes that are in 
absolute binary arithmetic into BCD. 

l.e. if A holds @@G@ 1010 a ‘DAA’ operation will give the A register 
containing: 606 1 @GQ@ as this is the BCD representation of decimal 16. 

The execution of a ‘DAA’ instruction does affect the flags. The Sign flag 
and the Zero flag are simply affected by the result in the usual way. The 
O/P flag tests the parity of the result. The reaction of the Carry flag is 
rather complicated as its value is affected by the state of the ‘Half carry 
flag’. 

In the 8K mGnitor program the ‘DAA’ instruction is only used occasion- 
ally and there are no easy examples that can be discussed. 

A BASIC program that demonstrates the ‘HALT’ instruction is to be 
found on page 108. 
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5. Demonstration Machine Code 
Programs 


5.1 An outline of the chapter 


This chapter contains 26 simple BASIC programs that illustrate the use 
of many of the machine code instructions of the Z80. All of the programs 
will RUN on a 1K ZX-81. 

The programs are arranged so that the instructions demonstrated 
follow the groups described in chapter 4. 

All the programs involve POKING machine code instructions into 
areas of ‘free’ RAM and then RUNNING the programs by using the USR 
command. 

The machine code instructions are entered as their decimal values, 
but the Hexadecimal equivalents will always be given together with the 
mnemonics. 


5.2 The Programs 


Group 1. The NO OPERATION and RETURN instructions 

(see also page 22) 

The following simple program shows the RETURN instruction being 
used as a ‘complete’ machine code program. 


Program 116 SLOW mnemonic Hex. code 
‘RET’ 20 POKE 17152,201 RET C9 

30 STOP 

4@ LET A=USR 17152 

5@ PRINT 

“THE PROGRAM HAS RUN” 


Enter the above lines and use RUN. Then use RUN 4@ to execute the 
actual machine code program. This program consists of only one 
machine code instruction — the RET instruction. 

The next program shows the use of the NO OPERATION instruction. 


Program 2 16 SLOW mnemonic Hex. code 
‘NOP’ 20 FOR A=@ TO 98 

30 POKE 17152+A,@ NOP GO 

46 NEXTA 

5@ POKE 17251, 21 RET Cg 

60 STOP 

76 LET A=USR 17152 

8@ PRINT 

“THE PROGRAM HAS RUN” 
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Enter the above lines and use RUN. Then use RUN 7@ to execute the 
actual machine code program. This time the program is 10@ bytes in 
length, being made up of ‘99 NO OPERATION instructions and a 
RETURN’. 

These first two programs do not do any useful ‘work’, but they do show 
that a machine code program RUN with the USR command requires a 
final ‘RET’ instruction in order to make a return to BASIC. 

The reader must understand just how the above BASIC programs 
work before reading further. 


Group 2. The instruction for loading registers with constants 
(see also page 24) 
The USR command returns to the programmer the contents of the BC 
register pair, as a decimal number. The monitor program however con- 
siders the BC register pair to be holding its numbers in absolute binary 
arithmetic, and this fact must always be remembered. 

The first program shows the simple use of a ‘LD B,+dd’ and a ‘LD 
C,+dd’ instruction. 


Program 3 mnemonic Hex. code 
‘LD 18 SLOW 
C,+dd 2@LETA=17152 

30 POKE A, 14 LD C,+dd GE 


4@ PRINT AT 18,0; “ENTER 
A VALUE FOR C (0-255)” 


50 INPUT C 

66 POKE A+1,C C 
70 POKE A+2,6 LD 8,+dd G6 
80 POKE A+3,0 Gd 
90 POKE A+4,261 RET C9 
160 CLS 


110 PRINT “C NOW 
CONTAINS”; USR 17152 
126 RUN 

RUN 


Note the use of the ‘USR 17152’ in the PRINT line. This is quite 
acceptable and can be very helpful. 

The second program for this group of instructions shows the ‘LD 
BC,+dddd’ instruction. 
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Program 4 mnemonic Hex. code 
‘LDBC, 10SLOW 
+dddd’ 2@0LETA=17152 

30 POKE A, 1 LD BC,+dddd @1 

46 PRINT AT 18,0; “ENTER 

A VALUE FOR BC (6-65535)” 

5@ INPUT BC 

6@ LET B=INT (BC/256) 

7@ LET C=INT (BC-B*256) 


80 POKE A+1,C C 
90 POKE A+2,B B 
1806 POKE A+3,261 RET C9 
110 CLS 


126 PRINT “BC NOW 
CONTAINS”; USR 17152 
130 RUN 

RUN 


So as to make the working of the above program a little clearer the 
assembler listing of the 2 instruction line machine code program is given 
below. 


address Hex. code mnemonic comment 
4300 01CB LD BC,+dddd Load the 
constant ‘BC’. 
363 C9 RET Return to the 
BASIC. 


Group 3. Register copying and exchanging instructions 

(see also page 25) 

The register copying instructions can be demonstrated by loading re- 
gisters with constants and then by copying those constants to the B and 
C registers for returning to the programmer. 

The first program shows the ‘LD C,L’ instruction. In the program a 
constant is loaded into the L register and then copied into the C register. 
The B register is loaded with the constant @ so as to make the program 
less complicated. 
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Program 5 mnemonic 
‘LDOC,L’ 10 SLOW 

20 LET A=17152 

30 POKE A,46 LDL,+dd 

490 PRINT AT 18,0; “ENTERA 

VALUE FOR L (@-255)” 

50 INPUT L 

6@ POKE A+1,L 

70 POKE A+2,77 LDC,L 

8@ POKE A+3,6 LD B,+dd 

9G POKE A+4,G@ 

100 POKE A+5,261 RET 

116 CLS 

126 PRINT “L WAS LOADED 

WITH’; L 

136 PRINT 

140 PRINT “AND NOW 

C CONTAINS”; USR 17152 

150 RUN 

RUN 


Hex. code 


2E 


4D 
G6 


C9 


The reader is encouraged to use different registers and different 
instructions in the above program when the principle of the program has 


been understood. 


The second program for this group of instructions demonstrates the 


important ‘EX DE,HL’ instruction. 


In the program the value entered by the programmer takes a ‘tour’ 
round the main registers before emerging unchanged (hopefully). 


Program 6 mnemonic Hex. code 
‘EX 10 SLOW 
DE,HL’ 20 LET A=17152 
30 POKE A,33 LD HL,+dddd 21 
40 PRINT AT 18,0; “ENTERA 
VALUE FOR HL (@-65535)” 
50 INPUT HL 
66 LET H=INT (HL/256) 
7@ LET L=INT (HL-H*256) 
80 POKE A+1,L L 
90 POKE A+2,H 7 H 
100 POKE A+3,235 EX DE,HL 
110 POKE A+4,74 LDC,D 4A 
120 POKE A+5,67 LD B,E 43 
130 POKE A+6,81 LD D,C 51 
58 


14@ POKE A+7,88 LD E,B 
86 


158 POKE A+8,235 EX DE,HL EB 


160 POKE A+9,68 ~ LDB,H 44 
176 POKE A+10,77 LDC,L 4D 
180 POKE A+11,201 RET C9 
198 CLS 


20@ PRINT “HL WAS 
LOADED WITH” ; HL 

210 PRINT 

220 PRINT “AND NOW 

BC CONTAINS” ; USR 17152 
230 RUN 

RUN 


The reader is again encouraged to try different instructions in the 
above program. 


Group 4. Instructions for the loading of the registers with data copies 
from a memory location. (see also page 28). 

The instructions in this group allow the programmer to load registers with 
copies of the contents of locations that are addressed using absolute, 
indirect or indexed modes of addressing. 

The first program demonstrates ‘absolute addressing’. In this mode 
the address of the location is kept as two bytes of data that follow the 
instruction proper. 

Initially a chosen location in memory — address 17152, Hex.430@ - is 
filled using a POKE command. Than a ‘LD A,(addr.)’ instruction copies 
the contents of location 17152 into the A register. Other instructions are 
then used and the return made to BASIC. 


Program 7 mnemonic Hex. code 
‘LD 10 SLOW 
A,(addr.)’ 20 PRINT AT 18,0; “ENTERA 

VALUE FOR LOCATION 17152 

(@-255)” 

30 INPUT VALUE 

40 POKE 17152, VALUE 

SOLET A=17153 


60 POKE A,58 LDA,(addr.) 3A 
76 POKE A+1,@ 00 
8@ POKE A+2,67 43 
90 POKE A+3,79 LDC,A 4F 
10@ POKE A+4,6 LD B,+dd G6 
11@ POKE A+5,@ GG 
12@ POKE A,+6,2061 RET C9 
13@ CLS 
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146 PRINT “INPUT VALUE 

WAS"; VALUE 

150 PRINT 

160 PRINT “C REGISTER NOW 
CONTAINS”; USR 17153 NOTE: 17153 
170 RUN 

RUN 


The second program demonstrates ‘indirect addressing’. In this mode 
the address of the location has to be placed in an ‘addressing register 


pair’. 


In the following program the HL register pair is loaded with the address 
17152, Hex.43@@ and the contents of that location returned to the 
programmer. 


Program 8 mnemonic Hex. code 


‘LD 
C,(HL)’ 


16 SLOW 

20 PRINT AT 18,0; “ENTERA 
VALUE FOR LOCATION 
17152 (@-255)” 

30 INPUT VALUE 

46 POKE 17152, VALUE 

5@ LET A=17153 


6@ POKE A,33 LDHL,+dddd 21 
76 POKE A+1,@ GO 
86 POKE A+2,67 43 
98 POKE A+3,78 LD C,(HL) 4E 
166 POKE A+4,6 LD B,+dd G6 
110 POKE A+5,@ OG 
126 POKE A+6,201 RET Cg 
136 CLS 

14@ PRINT “INPUT VALUE 

WAS"; VALUE 

150 PRINT 


16@ PRINT “C REGISTER NOW 
CONTAINS”; USR 17153 

170 RUN 

RUN 


The third program demonstrates ‘indexed addressing’. In this mode a 
block of memory is considered to be a table or a list of which the ‘base 
address’ is known. The position of the required location must also be 


known. 
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in the ZX-81 system, especially in ‘slow’ mode it is not very practical to 
change the contents of the IX or the IY register pairs so the following 
program uses the monitor program’s base address of Hex. 400@ and the 
location that is ‘indexed addressed’ is in the ‘printer buffer’, which is at 
Hex. 403C-405C. (16444-16476). 


Program 9 mnemonic Hex. code 
‘LD 16 SLOW 
C,(I¥+d)’ 20 PRINT AT 18,4; “ENTERA 
VALUE FOR LOCATION 
16444 (@-255)” 
30 INPUT VALUE 
4@ POKE 16444, VALUE 
56 LET A=17152 
6@ POKE A,253 LDC,(IY+d) FD 
70 POKE A+1,78 4E 
8G POKE A+2,6¢ 3C 
9¢ POKE A+3,6 LD B,+dd G6 
10@ POKE A+4,@ 60 
11@ POKE A+5,201 RET Tt) 
126 REM 
13@ CLS 
140 PRINT “INPUT VALUE 
WAS”; VALUE 
150 PRINT 
168 PRINT “ENTRY D= ““3C” ” | 
IS”;USR 17152 (shifted Qs.) 
17@ RUN 
RUN 


The reader is encouraged to change the parameters in lines 26, 40 
8 and 169, to examine other locations. 


Group 5. Instructions for loading locations in memory with data copied 
from registers, or with constants. (see also page 33) 
The instructions in this group allow the programmer to load memory 
locations with data copied from registers and to load addressed locations 
with constants. 
Once again absolute, indirect and indexed addressing can be used. 
The first program shows the ‘LD (addr.),A’ instruction. In the program 
the user is asked to enter a ‘VALUE’ and an ‘ADDRESS’ and then the 
machine code routine will ‘load’ the specified location. APEEK command 
is used to show the user that the operation is successful. 
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Program mnemonic Hex. code 
10 16 SLOW 
LD 26 PRINT AT 18,0; ENTERA 
(addr.),A’ VALUE (@-255)” 
3@ INPUT VALUE 
40 CLS 
50 LET A=17152 
60 POKE A,62 LD A,+dd 3E 
76 POKE A+1, VALUE VALUE 
8@ PRINT AT 18,0; “ENTER 
THE ADDRESS OF A 
LOCATION (16384-17407)” 
90 INPUT ADDRESS 
100 CLS 
110 LET H=INT 
(ADDRESS/256) 
126 LET L=INT 
(ADDRESS-H*256) 
138 POKE A+2,56 LD (addr.)A 32 
140 POKE A+3,L 
15@ POKE A+4,H 
160 POKE A+5,201 RET 
170 LET K=USR 17152 
180 PRINT “INPUT VALUE 
WAS"; VALUE 
196 PRINT 
206 PRINT “LOCATION”; 
ADDRESS; “HOLDS”; 
PEEK ADDRESS 
210 RUN 
RUN 


The user of the above program must be careful to choose a value for 
‘ADDRESS ' that is sensible. in this particular case locations 17158 to 
1730G are definitely ‘free’ locations. 

The second program shows ‘indirect addressing’ being used to ad- 
dress the required location. A ‘LD (HL),E’ instruction is used to ‘load’ that 
location. 


QO x 
© 


Program mnemonic Hex. code 
11 10 SLOW 
‘LD 20 PRINT AT 18,0; “ENTERA 


(HL),E’ VALUE (@-255)” 
3@ INPUT VALUE 
40 CLS 


90 


5@ LET A=17152 


66 POKE A,3d LD E,+dd 1E 

70 POKE A+1, VALUE VALUE 
86 PRINT AT 18,0; “ENTER 

THE ADDRESS OF A 


LOCATION (16384-17407)” 
96 INPUT ADDRESS 


10@ CLS 

116 LET H=INT 

(ADDRESS/256) 

120 LET L=INT 

(ADDRESS-H*256) 

130 POKE A+2,33 LDHL,+dddd 21 
140 POKE A+3,L L 
150 POKE A+4,H H 
160 POKE A+5,115 LD (HL),E 73 
170 POKE A+6,201 RET cg 


186 LET K=USR 17152 
198 PRINT “INPUT VALUE 
WAS"; VALUE 

260 PRINT 

218 PRINT “LOCATION’, 
ADDRESS;” HOLDS”; 
PEEK ADDRESS 

226 RUN 

RUN 


Once again the user must choose the value for ‘ADDRESS’ sensibly. 
Locations 17159 to 17306 are ‘free’ locations. 

The third program for this group uses ‘indexed addressing and de- 
monstrates the ‘LD (IY+d),+dd’ instruction. Again the ‘base address’ of 
Hex. 4009 is used and the indexed locations all form part of the ‘printer 


buffer’. 


Program 
12 


LD 
(IY +d), 
+dd’ 


mnemonic Hex. code 
10 SLOW 
26 PRINT “ENTRY NO.” 
“CONTENTS” 
30 PRINT 
46 FOR |=6@ TO 7G 
5@ PRINT |, PEEK (16384 +1) 
60 NEXT |! 
70 PRINT AT 18,4; “ENTERA 
VALUE (@-255)” 
86 INPUT VALUE 
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In the above program the user can ‘load’ values into a part of the 
printer buffer. Note that in the program the ‘displacement’ value D is in 
decimal arithmetic. The locations would more normally be described in 


90 PRINT AT 18,0; “WHICH 

LOCATION? (60-7@6)” 

10@ INPUT D 

11@ IF D<60 OR D>70 THEN 

GOTO 104 

120 LET A=17252 NOTE: 17252 

130 POKE A,253 LD(IY +d), 
+dd 

14@ POKE A+1,54 

15@ POKE A+2,D 

16@ POKE A+3, VALUE 

176 POKE A+4,261 RET 

18@ LET K=USR 17252 

198 CLS 

200 RUN 

RUN 


Hex. as '1Y+3C’ to ‘IY +46:.. 


Group 6: The addition instructions. 
(see also page 36) 


There are three subgroups of instructions within this group. The ADD 
instructions perform straightforward addition operations in absolute bi- 
nary arithmetic. The INC instructions simply increment the byte or bytes 
specified. The ADC perform addition together with incrementation if the 


Carry flag is Set. 


36 


VALUE 


C9 


The first BASIC program shows the ‘ADD A,+dd' instruction. 


Program 
13 

ADD 
A,+dd' 


mnemonic 
10 SLOW 
20 PRINT AT 18,0; ‘ENTER 
FIRST VALUE (@-255)” 
30 INPUT F 
40 PRINT AT 18,0; “ENTER 
SECOND VALUE (@-255)” 
50 INPUTS 
60 CLS 
7@ LET A=17152 
80 POKE A,62 LD A,+dd 
90 POKE A+1,F 
100 POKE A+2,198 ADD A,+dd 
110 POKEA+3,S 
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Hex. code 


3E 


C6 


120 POKE A+4,79 LDC,A 4F 


136 POKE A+5,6 LD B,+dd 66 
146 POKE A+6,@ GG 
150 POKE A+7,201 RET C9 


160 PRINT “ADDITION”; 
F:“ + ue SS: USR 17152 
17¢ RUN 

RUN 


In the above program the first value, F, is loaded into the A register. 
The second value becomes the data byte associated with the ‘ADD 
A,+dd’ instruction. The program does show the ‘addition in absolute 
binary arithmetic’ quite truthfully. 

The second program for this group demonstrates the ‘INC BC’ instruc- 
tion. Again the operation is performed in absolute binary arithmetic. 


Program mnemonic Hex. code 
14 16 SLOW 
INC BC’ 2@ PRINT AT 18,0; “ENTER 
VALUE FOR BC (@-65535)” 
30 INPUT BC 
40 CLS 
506 LET B=INT (BC/256) 
6@ LET C=INT (BC-B*256) 
76 LET A=17152 
80 POKE A,1 LD BC,+dddd @1 
96 POKE A+1,C C 
160 POKE A+2,B B 
116 POKE A+3,3 INC BC 03 
120 POKE A+4,201 RET C 
136 PRINT “OLD CONTENTS 
OF BC = "; BC 
140 PRINT 
15@ PRINT “WHEN 
INCREMENTED BC="; 
USR 17152 
166 RUN 
RUN 


Try entering a value of 65535. 

There is no program to illustrate the ‘ADC’ instruction but an ‘ADC 
+dd’ instruction is used in the first program for the next group of 
instructions. 
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Group 7: The subtraction instructions. 
(see also page 40) 
Once again there are three subgroups of instruction in this group. 

The SUB instructions perform straightforward subtraction. The DEC 
instructions simply decrement the specified byte or bytes. The SBC 
instructions perform subtraction and also decrementation if the Carry 
flag is Set. 

The use of the Carry flag is very important and the first program shows 
how: 

operations that are 

F >S give Carry Reset. 

F= S$ gives Carry Reset and 

F < S give Carry Set. 

(F is a first value, S is a second value) 

All subtraction operations are in ‘absolute binary arithemtic’. 

In the first program, that illustrates the ‘SUB +dd’ instruction, there is a 
change in the method of loading the machine code into the ZX-81. 

Line 1G, the first line in the BASIC program is a REM statement that 
has 16 characters that are used to reserve space for the machine code 
program. 

The change is required as in a standard IK ZX-81 there is very little 
“free RAM available when a large BASIC is entered, and it is a good idea 
to reserve space by using a ‘dummy’ REM line. 


Program mnemonic Hex. code 
15 10 REM 1234567890123456 (16 bytes) 
SUB 26 SLOW 
+dd’ 390 PRINT AT 18,0; “ENTER 
VALUE ONE (@-255)” 


40 INPUT F 

5@ PRINT AT 18,12;“TWO"” 

60 INPUTS 

70 CLS 

80 LET A=16515 Note: 16515 

9¢ POKE A,62 LD A,+dd SE 
166 POKE A+1,F F 
11@ POKE A+2,214 SUB +dd D6 
126 POKE A+3,S S 
130 POKE A+4,79 LDC,A 4F 
146 POKE A+5,6 LD B,+dd G6 
150 POKE A+6,@ GG 
166 POKE A+7,62 LD A,+dd SE 
176 POKE A+8,@ OG 
186 POKE A+9,206 ADC A, +dd CE 
196 POKE A+ 10,0 0G 
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200 POKE A+11,5@ LD (addr.),A 32 

210 POKE A+12,130 
: (1st character) 82 

226 POKE A+13,64 (in tine 10) 4G 

23G6 POKE A+14,261 RET C9 

240 PRINT “SUBTRACTION”; 

F:“—":S:“="-USR 16515,, 

“CARRY”; Note: USR 16515 

256 IF NOT PEEK 16514 

THEN PRINT “RE’” 

260 PRINT “SET” 

2780 RUN 

RUN 


Try the above program with; 
24-—-12togive 12 & Carry Reset 
24—24togive @ & Carry Reset and 
24 — 25 to give 255 & Carry SET 


In the program F takes the value of the First value entered. S takes the 
value of the Second value. 

A ‘SUB +dd' instruction performs the subtraction. The result is then 
put into the BC register pair. 

The value of the Carry flag is then found by using a ‘ADC+@@’ 
instruction, this value is stored in location 16514 and subsequently read 
with a PEEK command. 

The DEC instructions are so similar to the INC instructions (though 
opposite in action) that the following changes to program 14 can be used 
if wished. - 


mnemonic Hex. code 
1180 POKE A+3,11 DEC.BC GB 
150 PRINT “WHEN 
DECREMENTED BC=": 
USR 17152 


There is no program to demonstrate the SBC instructions as they are 
commonly used as straighforward subtraction instructions by using ‘AND 
A before the ‘SBC’ so as to clear the Carry flag. 


Group 8; The Compare instructions. (see also page 44) 
The Compare instructions in effect perform a simple subtraction opera- 
tion, set the state of the flags and then discard the result. 

As the compare operation is so similar to subtraction the instructions 
can be demonstrated by modifying program 15. 
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Therefore change in program 15: 


mnemonic Hex. code 
116 POKE A+2,254 CP +dd FE 
240 PRINT “COMPARISON”, 
F>":"; S, “CARRY”; 


245 LET K=USR 16515 
Again try ‘greater than’, ‘equals’ and ‘less than’ comparisons and see 
how the state of the Carry flag changes. 


Group 9; The Logical instructions. (see also page 45) 
The instructions in this group allow the programmer to perform the logical 
operations of AND, OR and XOR. 

The first program shows the ‘AND +dd' instruction. In this BASIC 
program the'free RAM' of the ‘printer buffer’ is used to hold the machine 
code program. 


mnemonic Hex.code 
16 SLOW 
20 PRINT AT 18,0; “ENTER 
VALUE ONE (@—255)” 

Program 30 INPUTF 

16 40 PRINT AT 18,12; “TWO” 

‘AND 50 INPUTS 

+dd’ 60 CLS 
7@ LET A= 16445 
80 POKE A,62 LD A,+dd 3E 
90 POKE A+1,F F 
16@ POKE A+2,23¢ AND +dd E6 
118 POKEA+3,S S 
120 POKE A+4,5@ LD (addr.),A 32 
13@ POKE A+5,6@ (1st location 3C 

of PRBUFF) 

140 POKE A+6,64 40 
15@ POKE A+7, 201 RET C9 


160 LET K=16445 

17@ PRINT “LOGICAL” ;F; 
“AND";S;“IS” ;PEEK 16444 

18@ RUN 


The above program works in decimal arithmetic, but the logical opera- 
tions are performed in binary by the Arithmetic-logic-unit of the Z80. 

To demonstrate the OR operation the following changes can be made 
to program 16. 
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100 POKE A+2,246 OR +dd F6 
170 PRINT“LOGICAL”;F;“OR” 
0; 1S";PEEK 16444 


To demonstrate the XOR operation 


100 POKE A+2,238 
176 PRINT “LOGICAL”:F; 
“XOR":S;"IS” ;PEEK 16444 


Group 10; The Jump instructions. (see also page 49) 

In this group are the unconditional and the conditional Jump instructions, 
and the jumps made can be to an absolute addressed location or to a 
‘relative’ addressed location. 

The following program shows how the different results of a simple 
addition operation set the flags and hence permit or otherwise a jump to 
be made. 

The program initially asks the user to specify an instruction, and the 
following are permitted instructions for this program: | 


decimal mnemonic Hex.code 
24 JRe 18e 
32 JR NZ,e 20e 
40 JR Z,e 28 e 
48 JR NC,e 30e 
56 JR C,e 38 e 
The decimal value must be entered. 
mnemonic Hex.code 
18 SLOW 
20 PRINT AT 18,0; “ENTER 
Program INSTRUCTION” “E.G. 
17 <4@> FOR <JRZ,E>” 
‘JRe 
30 INPUTB 
40 CLS 
50 PRINT AT 18,0; ENTER 
VALUE ONE (@-255)” 
6@ INPUTF . 
7@ PRINT AT 18,12; “TWO” 
8@ INPUTS 
98 CLS 
100 LET A=16445 
1186 POKE A,1 LD BC,+dddd 01 
120 POKE A+1,d 00 
130 POKE A+2,d GG 


140 POKE A+3,62 LD A,+dd SE 
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150 POKE A+4,F F 


160 POKE A+5,198 ADD A,+dd C6 
170 POKEA+6,S S 

18@ POKE A+7,5d LD (addr.),A 32 
190 POKE A+8,6d 3C 
26@ POKE A+9,64 40 
210 POKE A+1@,B JRe B 

220 POKE A+11,1 1 

230 POKE A+12,201 RET C9 
240 POKE A+13,3 INC BC 03 
250 POKE A+14,261 RET C9 


266 LET C=USR 16444 

270 PRINT F;"+”";S;“="PEEK 16444 
280 IF NOT C THEN PRINT 

“NO”: 

290 PRINT “JUMP” 

300 RUN 

RUN 


Note: The user must be careful to enter only valid instructions. 
SAVEing the program is advised. 


In the above program the BC register pair is initially set to contain zero. 
However if a jump is made the value in BC is incremented, and the 
incremented value returned to the user. 

The above program can be simply changed to give examples of the 
‘absolute’ addressing instructions. 

The following instructions are then valid: 


decimal mnemonic Hex. code 
195 JP addr. C3 addr. 
194 JP NZ, addr. C2 addr. 
202 JP Z, addr. CA addr. 
210 JP NC, addr. D2 addr. 
218 JP C, addr. DA addr. 
226 JP PO, addr. E2 addr. 
234 JP PE, addr. EA addr. 
242 JP P, addr. F2 addr. 
250 JP M, addr. FA addr. 


The changes to program 17 are: 
20 PRINT AT 18,0;“ENTER 
INSTRUCTION”, “E.G. <250> 
FOR <JPM,ADDR.> ” 
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220 POKE A+11,75 (location A+14) 


4B 
230 POKE A+ 12,64 40 
240 POKE A+13,261 RET Cg 
250 POKE A+ 14,3 INC BC 03 
255 POKE A+15,201 RET C9 


The user can alter the location A+5 if wished. 


E.g. changes lines: 
166 POKE A+5,214 
276 PRINTF; — ";S;‘=":PEEK 
16444 
will change the addition operation to subtraction. 


Group 11; The ‘DJNZ e’ instruction (see also page 59) 
This very commonly used instruction can be considered to be equivalent 
to the BASIC NEXT command. 

The following very simple program shows a FOR... NEXT loop being 
used to SUM a series. 


10 SLOW 

20 PRINT “THE SUM OF THE 
SERIES","1,2... 254,255" 
30 PRINT 

40 PRINT “=": 

50 INPUT AS 

60 LET SUM=0 

70 FORC=255TO 1 STEP 
-1 

80 LETSUM=SUM+C 

90 NEXTC 

10@ PRINT SUM 


The program includes the line 5¢ INPUT A$ as a waiting point for the 
user — simply press NEWLINE. 

As written the second half of the program takes 9 seconds to produce 
the answer 32640. 

The following program demonstrates the ‘DJNZ e’ instruction being 
used in the equivalent machine code program. 


18 SLOW 


20 PRINT “THE SUM OF 
THE SERIES" ,“1,2... 254,255” 


30 PRINT 
Program 40 PRINT “=”; 
18 5@ LET A=16444 
DJNZe 60 POKEA,33 LDHL,+dddd 21 
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70 POKE A+1,0 GG 


86 POKE A+2,0 Gd 

90 POKE A+3,85 LD D,L 55 
100 POKE A+4,6 LD B,+dd G6 
110 POKE A+5,255 FF 
126 POKE A+6,88 LDE,B 58 
1386 POKE A+7,25 ADD HL,DE 19 
140 POKE A+8,16 DJNZ e 1G 
15@ POKE A+9,252 FC 
160 POKE A+16,68 LD B,H 44 
17@ POKE A+11,77 LDC,L 4D 
186 POKE A+12,2¢1 RET C9 
190 INPUT AS 


200 PRINT USR 16444 


As written the above program takes in ‘slow’ mode about a second. 
However by changing line 10 to; 16 FAST and running the program 
again, it will be seen to be very much quicker. 

The above program is worth studying in further detail as it really is the 
first functional program in the book. | 

The ‘assembler listing is as follows; 


address Hex. code Label mnemonic Comment 

403C 210000 START LDHL,,+@@0@0 Clear HL for answer. 
O3F 55 LD D,L Set D to zero. 
040 06 FF LD B,+FF For 255 times. 
G42 58 FOR LDE,B Transfer to low 

register. 

643 19 ADD HL,DE For part answers. 
044 10 FC NEXT DJNZ FOR Go back. 
046 44 LD B,H Transfer to USR. 
047 4D LDC,L Transfer to USR. 
048 C9 END RET Return. 


This 13 byte routine can be considered to be a subroutine to be used 
on any occasion where there is the need to sum a series of suitable 
numbers. 


Group 12; The Stack instructions. (see also page 67) 
The first subgroup of instructions in this group consist of those instruc- 
tions that can be used by the programmer to store data temporarily on the 
stack. The second subgroup consists of those instructions that use the 
stack themselves to hold ‘return addresses’. 

The following program shows the stack being used to hold the value 
entered by the user, this value is then ‘popped’ off the stack and returned 
to the user. 
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The program shows how a value can be moved from one register pair 
to another by the use of the appropriate ‘PUSH’ and ‘POP’ instructions. 


186 SLOW 


26 PRINT AT 18,0; “ENTERA 


VALUE FOR HL (@-65535)” 


Program 
19 
‘PUSH 
HL’ 


30 


INPUT HL 


40 CLS 


50 


6@ LET L=INT (HL=H"256) 
76 PRINT “HL WAS FILLED 
WITH" HL 


LET H=INT (HL/256) 


8@ PRINT 
9¢ PRINT “BC NOW 


10@ 
110 
12¢ 
13d 
14@ 
150 
16@ 
17@ 
180 


The second 


decimal 
205 
2206 
212 
204 
196 
236 
228 
252 
244 


CONTAINS”: 


LET A= 16444 
POKE A,33 

POKE A+1,L 
POKE A+2,H 
POKE A+3,229 
POKE A+4,193 
POKE A+5,2@1 
PRINT USR 16444 
RUN 


mnemonic 


Hex. code 


LD HL,+dddd 21 


PUSH HL 
POP HL 
RET 


L 
H 
E5 
C1 
C9 


program demonstrates the absolute CALL and the 
conditional CALL instructions. The program is similar to program 17 that 
showed the conditional JP instructions. 
The user is first asked to enter the ‘instruction’, in decimal, and then the 
values for an addition operation. The program then shows whether or not 
the CALL instruction would be used to run a subroutine. 
The following instructions are valid for the program: 


mnemonic 
CALL addr. 
CALL C, addr. 


CALL NC, addr. 


CALL Z, addr. 


CALL NZ, addr. 
CALL PE, addr. 
CALL PO, addr. 


CALL M, addr. 
CALL P, addr. 


Hex 


CD addr. 
DC addr. 
D4 addr. 
CC addr. 


C4 addr. 


EC addr. 


E4 addr. 


FC addr. 


F4 addr. 


The user is well advised to SAVE the program before running it for the 


first time. 
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If the subroutine is not called the program will print; ‘NO CALL’. 
However whenever the subroutine has been called the program will 
print the simple addition operation. 


mnemonic Hex. code 
10 SLOW 
20 PRINT AT 18,0; “ENTER 
INSTRUCTION”, “E.G. <252> 
FOR <CALL M,ADDR.>” 
Program 30 INPUTB 


20 40 CLS 
‘CALL 50 PRINT AT 18,G;‘ENTER 
addr.’ VALUE ONE (@-255)” 
6G INPUT F 
70 PRINT AT 18,12;“TWO” 
80 INPUTS 
98 CLS 
100 LET A=16445 
110 POKEA,1 LD BC+dddd @1 
120 POKE A+1,@ GO 
130 POKE A+2,0 GO 
140 POKE A+3,62 LD A,+dd 3E 
150 POKE A+4,F F 
166 POKE A+5,198 ADD A,+dd C6 
176 POKE A+6,S S 
180 POKEA+7,B CALL xxxxx B 
190 POKE A+8,72 (address of) 48 
200 POKE A+9,64 (A+11) 40 
210 POKE A+10,201 RET C9 
220 POKE A+11,3 INC BC G3 
230 POKE A+12,50 LD (addr.)A 32 
240 POKE A+ 13,60 3C 
(address of) 
250 POKE A+ 14,64 (A-1) 40 
260 POKE A+15,201 RET C9 


270 LET C=USR 16445 

280 IF C THEN PRINT F;" + 
"3S; ="PEEK 1644 

290 IF NOT C THEN PRINT 
“NO CALL” 

300 RUN 

RUN 
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In the program the result of the addition is stored in location 16444, 
from where it is read using a PEEK command if the subroutine was 
called. The value returned to the user in BC is used as a flag to show 
whether or not the subroutine was called. 

It is not possible to demonstrate the RST instructions as they all are 
‘preprogrammed in the 8K ROM. 

The exercise of writing a BASIC program to demonstrate the 
conditional RET instructions is left to the reader. 

Hint: Try changing program 20. Location A+7 could have a ‘CALL 
addr.’ instruction and location A+10 could have a conditional RET 
instruction. 


Group 13; The Rotation instructions. (see also page 66) 
There are seven main types of rotation. The following demonstration 
program shows the results of rotations on the C register. 
The user is allowed to Reset, or Set, the Carry flag prior to the rotation. 
As before the user is initially asked to enter the instruction to be used. 
The following instructions are valid 
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decimal mnemonic Hex. code 
1 RLCC CB G1 
17 RLC CB 11 
33 SLAC CB 21 
9 RRC C CB G9 
25 RRC CB 19 
41 SRAC CB 29 
ot SRL C CB 39 
10 SLOW 
26 PRINT AT 18,0; 
“ENTER 
INSTRUCTION”, 
“E.G A> FOR<RLC C"”> 
Program 30 INPUTB 
21 40 CLS 
‘RLC C' 5@ PRINT AT 18,0; 
“ENTER VALUE FOR 
CARRY (@ OR 1)” 
60 INPUT C 
70 CLS 
8@ PRINT AT 18,0; 
“ENTER VALUE FOR 
C (@-255)” 
9¢ INPUT D 
100 CLS 


110 LET A=16445 


126 POKEA,6 LD B,+dd G6 
13@ POKE A+1,@ GG 
140 POKE A+2,167-112*C XORAorSCF A7or37 
15@ POKE A+3,14 LDC GE 
166 POKEA+4,D D 
17@ POKE A+5,263 Rotation CB 
186 POKEA+6,B B 
19@ POKE A+7,62 LD A,+dd 3E 
200 POKEA+8,@ GG 
210 POKE A+9,206 ADC +dd CE 
2280 POKEA+16,@ GG 
230 POKE A+11,5¢ LD (addr.).A 32 
240 POKE A+ 12,60 (location of) 

3C 
250 POKE A+ 13,64 (A-1) 40 
266 POKE A+14,261 RET C9 
276 PRINT D;“ROTATES 

TO” ;USR 


16445;"CARRY”; 

280 LET E=PEEK 16444 

290 IF NOT E THEN PRINT 
“SET” 

360 IF E THEN PRINT 
“RESET” 

310 RUN 

RUN 


In the program the result of the rotation is stored in location 16444. The 
state of the Carry flag is read using an ‘ADC +dd’ instruction as before. 

The user is again advised to SAVE the program before using it for the 
first time, as the basic1K program does not have any ‘error checking’ on 
the input values. 

The user might like to try: Instruction=1, Carry=0, C=128 & 
Instruction=57, Carry=1, C=1 etc. 


Group 14; the ‘Bit handling’ instructions. (see also page 69) 
This group contains the BIT, RES and SET instructions. The BIT 
instructions allow the programmer to ‘test’ a particular bit in a specified 
byte. The RES and SET instructions allow the programmer to Reset or 
Set a particular bit. 

The following demonstration program shows the BIT type of 
instruction being used to convert a decimal number to its binary 
equivalent. 
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mnemonic Hex. code 


16 SLOW 
20 PRINT AT 16,0;“DECIMAL 
TO BINARY 
CONVERSION” 
3¢ PRINT AT 18,6;“ENTER 
DECIMAL NUMBER 
(@-255)” 
46 INPUTB 
Program 5@ CLS 
22 6@ PRINT AT 6,6;B;" ”; (3 spaces) 
‘BIT’ 70 LET A=16444 
8@ POKE A,1 LD BC,+dddd @1 
99 POKE A+1,@ Gd 
166 POKE A+2,@ 0G 
116 POKE A+3,62 LD A,+dd 3E 
126 POKE A+4,B B 
136 POKE A+5,203 BIT xxxx CB 
14@ POKE A+7,20G RET Z C8 
15@ POKE A+8,3 INC BC 63 
160 POKE A+9,201 RET C9 


176 FORC=1TO8 

18@ POKE A+6,135-C*8 (the eight BIT instructions) 
196 PRINT USR 16444; 

200 NEXTC 

210 RUN 


RUN 


In the program each bit of the byte containing B is tested in turn. The 
value of the BC register pair is then incremented if the bit is Set. The 
above program runs very slowly in ‘slow’ mode and would be very much 
faster if written totally in machine code. 

There are no demonstration programs to show the RES and SET 
instructions, but the reader is encouraged to write his own. 


Group 15; Block Transferring instructions and Block Searching instruc- 
tions (see also page 72) 
The instructions in this group are very important. They are however 
rather difficult instructions to use, unless the programmer has a clear 
understanding of just what he is trying to do. 

The first program shows the ‘LDIR’ instruction being used to move a 
block of code within the BASIC program area. 
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Enter these lines: 


1d 
20 
3G 
4¢ 
50 
60 
76 
80 
90 


REM 1234567896 1234567896 123 
REM ***COPY THIS MESSAGE*** 
SLOW 

FOR != 16514 TO 16536 

PRINT CHRS PEEK |; 

NEXT | 

PRINT 

FOR |= 16543 TO 16565 

PRINT CHRS PEEK |: 


100 NEXT I 
RUN 
When the above program is RUN the display will show the characters 
from lines 1@ and 2d. 


The addresses of the locations for the ‘start’ of these lines are there- 
fore; Line 10, decimal 16514, Hex. 40 82, Line 20 , decimal 16543, Hex. 
40 9F and the length of the lines are; decimal 23, Hex.d@ 17. 


With this information known enter the following demonstration prog- 
ram which will move the contents of line 20 to line 10 using a ‘LDIR’ 


instruction. 
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mnemonic Hex. code 
REM 1234567890 123456789@ 123 


20 REM ***COPY THIS MESSAGE*™* 
Program 30 SLOW 


23 40 LET A=16444 
‘LDIR’ 50 POKEA,33 LD HL,+dddd 21 
60 POKE A+ 1,159 (start of) OF 
76 POKE A+2, 64 (line 2G) 40 
86 POKE A+3,17 LDDE,+dddd 11 
90 POKE A+4,130 (start of) 82 
180 POKE A+5,64 (line 14 4@ 
110 POKEA+6,1 LD BC,+dddd @1 
120 POKE A+7,23 17 
13@ POKE A+8,@ 6G 
146 POKE A+9,237 LDIR ED 
150 POKE A+16,176 Bo 
160 POKE A+11,201 RET C9 
176 LET K=USR 16444 
180 LIST 
RUN 
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When the program is RUN it will be seen that the line 26 has been 
copied into the 23 reserved locations of line 14. 


The ‘assembler listing is given below. 


address Hex. code mnemonic comment 
403C 21 OF 46 LDHL,4G9F  Startofline 2d. 
O3F 11 82 40 LD DE,4@82 _—_ Startof line 1d. 
G42 011700 LDBC,@017 #Thenumber of 
characters. 
045 ED BO LDIR Block move. 
047 C9 RET Return to 
BASIC. 


The reader is encouraged to try his own programs using ‘LDIR’, 
‘LDDR’, ‘LD! and ‘LDD’. 

The second program shows the use of the ‘CPIR’ instruction. 

In the program a search is made in the 8K ROM for the first occurr- 
ences of the numbers 0-255. 


Program 
24 
‘CPIR’ 


mnemonic Hex. code 

10 SLOW 

20 LET A=16444 

3@ POKE A,62 LD A,+dd 3E 

40 POKE A+2,1 LD BC,+dddd @1 

5@ POKE A+3,@ (the 8k) GG 

6@ POKE A+4,32 (ROM) 32 

7@ POKE A+5,33 LDHL,+dddd 21 

86 POKE A+6,@ Tt) 

96 POKE A+7,@ 00 
106 POKE A+8,237 CPIR ED 
1180 POKE A+9,177 B1 
120 POKE A+10,68 LD B,H 44 
13@ POKE A+11,77 LD C,L 4D 
146 POKE A+12,261 RET C9 


156 FOR B=@ TO 255 

166 POKE A+1,B 

(match to this byte) 

17@ LET C=USR 16444 

180 IF +4 ee THEN PRINT B;“OCCURS FIRST 
AT’ ;C— 

190 IF C=8192 THEN PRINT 
B;“DOES NOT OCCUR” 

200 PAUSE 106 

210 NEXTB 
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Note that in line 18 that the location that holds the matching is given 
by ‘C-1’, as the HL register pair is incremented before the comparison is 
made. 

The above program is purposely simple and does not check the flags 
in the case of there being ‘no match’. 

It is of interest that the value decimal 153, Hex. 99, does I not occur 
in the whole of the monitor program. 


Group 16; The Input and Output instructions. (see also page 76) 

The instructions in this group allow the programmer to accept bytes of 
data from an external source, and to send bytes out from the Z80. 

The following simple program uses the‘OUT (+FF),A’ instruction to 
produce a ‘hum’ that can be recorded on a cassette tape. 

The program just starts to show how ‘music’ can be produced. 


mnemonic Hex. code 
1@ FAST Note; FAST 
2G LET A=16444 
Program 30 POKEA,6 LD B,+dd G6 
25 40 POKE A+1,255 FF 
‘OUT 50 POKE A+2,211 OUT (+FF),A D3 
(+FF),A 60 POKEA+3,255 FF 
76 POKE A+4,16 DJNZe 10 
86 POKE A+5,252 FC 
90 POKE A+6,201 RET Cg 


100 FOR B=1 TO 300 
116 LET K=USR 16444 
120 NEXT B 

RUN 


Group 17; The ‘Interrupt’ instructions. (see also page 78) 
There are no demonstration programs for these as there is no facility for 
the user to use the interrupt lines in a standard 1K ZX-81. 


Group 18; Miscellaneous instructions. (see also page 80) 
The only demonstration program for this group is the following program 
that shows the ‘HALT’ instruction being used in the ‘slow’ mode. 

in ‘slow’ mode the NMI is used to split the machine code into blocks. In 
the following program a ‘HALT instruction is used, however if the prog- 
ram is run in ‘fast’ mode the program will be lost, showing that there are 
no interrupts in ‘fast’ mode. 


108 


Program 
26 
“HALT 


16 
20 
36 
40 
56 
60 
7G 
80 


9¢ 


mnemonic Hex. code 
SLOW 
LET B=3 
LET A=16444 
POKE A,118 HALT 76 
POKE A+ 1,201 RET C9 
LET K=USR 16444 
CLS 
PRINT AT 
6-B,5;"INTERRUPT 
WORKING” 
LET B=-B 


100 GOTO6@ 
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Chapter 6. An Examination of the 8K 
monitor Program 


6.1 The need for a monitor program. 


The first point for discussion is whether or not a microcomputer system, 
such as the ZX-81 system, actually needs to have a monitor program at 
all. However, it is fairly obvious that when the power is turned on, the Z80 
microprocessor will start executing instructions sequentially. In the case 
of the Z80 the first instruction is collected from location Hex.0G@G@. But it 
is very important to realise that the microprocessor itself cannot in 
anyway know whether it is following a sensible machine code program, 
or just obeying ‘rubbish’. 

This state can be shown quite nicely by trying to use a ZX-81 from 
which the 8K ROM has been removed. If this is done, then the user will 
find that the screen display fails to appear and that the keyboard is 
inactive. 

In order therefore for a microcomputer system to work in an organised 
manner there must be a monitor program, and for a Z80 microprocessor 
system the program must be located from Hex.6000 onwards. 

The actual size of the monitor program is determined by the number of 
features that the manufacturer wishes to include in his microcomputer 
system. For example a hand-held games machine may require a monitor 
program that occupies less than 2K (512 locations) of memory, whereas 
a large microcomputer system may have over 100K of memory holding 
its monitor program. 

The standard ZX-81 system is at present supplied with an 8K monitor 
program. The manufacturer thereby is able to offer a system which can 
produce and maintain a T.V. display which has 64 different characters, 
scan a keyboard with 78 different keystrokes and give the user the 
BASIC language. 

In the future it is likely that there will be a range of monitor programs 
availablesome of which may be smaller and therefore more elementary, 
and some which are larger and offer enhanced facilities. 


6.2 A first look at the structure of the 8K monitor 
program. 
The 8K monitor program can be divided into the following parts. 


G0GG The RST routines. 
GG7E The character tables. 
G207 The display routines. 
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G2F6 


The SAVE and LOAD command routines. 


G3CB The initialisation routine. 

0419 The BASIC line editing routines. 
Q@C29 The BASIC command tables. 
GCBA The BASIC line scanning routine. 
@DAB The BASIC command routines. 
OF52 The BASIC expression evaluator. 
1586 The floating-point handling routines. 
1914 The function table. 

199C The floating-point calculator. 
1E0@ The character generator. 

1FFF end. 


The 8K monitor program can therefore be seen to be made up of 14 
significant parts. In general the routines involved with the display are 
situated near the beginning of the program, the BASIC interpreter in the 
middle and the floating-point routines towards the end. The 8K ROM also 
holds the ‘formats’ of the 64 display characters in the character generator 
that occupies the top VeK. 

Before discussing these different parts of the monitor program it is 
worth while considering a functional model of the ZX-81. 


6.3 A function model of the ZX-81. 


When the power is turned on the first routine to be performed is not, 
surprisingly, the ‘initialisation routine’. However, after that the ZX-81 
enters a loop which is comprised of the ‘keyboard scanning routine’ and 
the main ‘display routine’. The computer stays in this program loop until a 
key is pressed on the keyboard. 

When this occurs an exit is made from the loop and some action is 
taken. This action leads to the execution of those routines associated 
with the keystroke. The routines may invoive ‘editing the display’, ‘enter- 
ing a character to the E-line’ or ‘running a BASIC program’. 

Once the appropriate routines have been executed the computer 
returns to its ‘keyboard and display loop’, where the whole procedure can 
be repeated. 

The above description applies very well to the ‘fast’ mode of operation 
of the ZX-81. However the operation of the ‘slow’ mode is more comp- 
licated. The most simple view possible is to consider that when the Z80 is 
executing any routine outside the ‘keyboard and display loop’ there are 
repeated ‘interrupts’ on the NMI line. Each interrupt leads to the execu- 
tion of a ‘display routine’. 

The following diagram shows these operations. 
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Diagram 10 A functional model of the ZX-81. 
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6.4 The different parts of the 8K monitor program. 


Each of the 14 parts of the monitor program will now be discussed in turn. 
The parts of program that are useful to a programmer writing his own 
programs will be given more explanation than the parts that cannot easily 
be used. | 


The RST routines: 

The RST locations are used for the following purposes: 
0000 Start. 

0008 Report handling. 

G01G Print a character. 

0018 Collect a character from a BASIC line. 
0020 Collect next character from a BASIC line. 


0028 Jump to floating-point calculator. 

0030 Make space in memory. 

0038 IM1 interrupt routine for each display line. 
& 


0066 NM interrupt for ‘slow’ display routine. 
RST locations 6@@8 and @@1@ are worth discussing further. 
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‘RST 0008’ 

When a report is required a ‘RST 00@8' instruction is used. The value 
of the report is required as data in the following byte. The operation of the 
report handling facility can be shown using the following BASIC program. 


mnemonic Hex. code 
18 SLOW 
20 POKE 17006 ,207 RST 0608 CF 
36 POKE 17001,34 22 


40 LET K=USR 170060 
9@ PRINT “LINE 50” 


When the above program is RUN it will be seen that “LINE 50” is never 
printed as report ‘Z’ has occurred in line 40. 
The actual lines from the monitor program that are involved are: 


address Hex. code mnemonic comment 
0008 2A 16 4G LD HL,(4016) SaveCH-ADD | 
00GB 22 18 44 LD (4018),HL in X-PTR 
OGE 18 46 JP 0056 Jump. 
056 E1 POP HL Get data byte 
address offstack 
Q57 6E LD L,(HL) Transfer to L. 
058 FD 7500 LD (40@@),L Toreport code. 
G5B ED 7B0240 LDSP,(4002) Prepare to clear 
stack. 
O5F ....., Clear stack & 
return. 


A programmer may find it useful therefore to use ‘RST 0008’ in his 
programs to define his own type of errors. 


‘RST 0010’ 

When a character is to be printed the most common method used is to 
load the A register with the appropriate character code and use a ‘RST 
0010’ instruction. The example from the 8K monitor program on page 64 
shows this being done. 

The actual lines of the RST 0010 routine are: 


address Hex. code mnemonic comment 
0010 A7 ANDA Is ita space? 
011 C2 F107 JP NZ,07F1 No. Print a 
character. 
014 C3 F507 JP O7F5 Yes. Printa 
space. 


This routine will always print a character in the next piace in the Display 
File, and it is up to the programmer to ensure that the values of S-POSN, 
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the column number and the line number for the PRINT command, are 
correct. 


The Character tables: 
There are four tables in this part of the 8K monitor program. They are: 


007E — 00CB The keyboard character table. 
OOCC — 00F2 The function character table. 
OOF3 — 0110 The graphic character table. 
0111—01FB The command character table. 


The following simple BASIC program shows these tables: 


16 SLOW 

26 FOR A=126 TO 507 

30 IF A=204 OR A=243 OR A=273 
THEN PRINT ,,, 

46 PRINT CHRS PEEK A; 

50 NEXTA 


The program gives the ‘CHRS’ representation of each entry in the 
table. 

The editing commands however come to be displayed as question 
marks, as do the keystrokes that change the operating modes. 


The Display routines: 
The routines from 0207-02BA are concerned with the production of a 
display. 

The routine from 0207-0228 is used to determine whether the ‘slow’ or 
‘fast’ mode is being used and the routine from 0229-0291 is the ‘main 
display routine’. 

The following BASIC program can be used to demonstrate this second 
routine. 


10 PRINT “LINE 10° 

20 FAST 

30 LETK=USR 553 Hex. 0229 
RUN 


The effect of using ‘USR 553’ is to call the ‘main display routine’ and 
hence the display file is displayed in an ‘unfinished’ state. Note that the 
report message is not printed. However if a key is pressed then an exit is 
made from the routine and the display is completed and displayed. 

The main display routine is in itself made up of three major parts: 


i. Decrease and test PAUSE counter. 
ii. Scan keyboard. 
iii. Produce the display. 


The reader will therefore see that it is this routine that is used by the 
PAUSE command to hold the display for a specified period, and that a 
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PAUSE period is ended by exiting from this routine by making a 
keystroke. 

The routine at 0292-02B4 is the ‘slow’ mode display controlling 
routine, and the routine at 02B5-02BA is the routine that actually starts 
the display of a single line of characters. 

The ‘keyboard scanning routine’ is a very important routine and is to be 
found at 02BB-02E6. This routine can be used by the programmer if he 
wishes as is demonstrated in the following BASIC program. 


mnemonic Hex. code 
16 REM 123456 
230 PRINT “AFTER NEWLINE 


HOLD DOWN A KEY” 
3G INPUT AS 
48 CLS 
50 LET A=16514 
. 60 POKEA,205 CALL dddd CD 
76 POKE A+1,187 BB 
86 POKE A+2,2 G2 
99 POKE A+3,68 LD B,H 44 
100 POKEA+4,77 LDC,L 4D 
11@ POKE A+5,201 RET C9 
126 FOR A=1 TO 106 
130 NEXTA 
14@ PRINT “KEY VALUE 
= "-USR 16514 
RUN 


Note that the key value returns from the routine in the HL register. (see 
appendix iv. on page 162 for the complete ‘Table of Key Values’. 

The key values represent the 79 unique codes that are derived from 
the scanning of the keyboard. In the keyboard decoding routine at 
07BD-07DB these values are first changed to an ordered sequence, 
1-78, and the character code obtained by referring to the character 
tables. ‘No key pressed’ being detected beforehand. (see also page 38) 

In a machine code program it is quite practical to call this routine and 
test the resulting contents of the HL pair against the key values, thereby 
detecting whether or not specific keys are being pressed. (See page 140) 
(see page 153 for a full listing of the ‘Keyboard scanning routine’) 


The SAVE and LOAD command routines: 

The main part of the save routine is at 02F6-033F, and the LOAD 
routine from 0340-03A1. 

In the ZX-81 system programs saved on cassette tape must have 
program names. These names are to be found on tape before the actual 
variables and program. As usual the end of a word, or name, is marked 


115 


by having the last letter ‘inverted’. 

In the case of the SAVE command routine there is the initial pause, 
O02FC-030A, followed by the sending of the program name, 030B-0312, 
and finally the sending of the system variables, the program and the 
program variables. Note that the display file is also copied to the tape. 

The following lines show some of these features. 

in FAST mode enter: 

LET A=USR 787 


After pressing NEWLINE the program will be SAVEd directly. 
LET A=USR 763 | 

and after pressing NEWLINE there will be the familiar 5 second pause 
before the SAVEing of the program. 

In the case of the LOAD command the program name is read in first, 
followed by the program. 

The use of the following line shows that this routine can be entered 
directly also. 

In FAST mode enter: 

LET A=USR 839 | 
and the familiar ‘waiting for data’ pattern will appear. 

A full listing of the ‘SAVE command routine’ and the ‘LOAD command 
routine’ are given in appendix i on page 150. 


The Initialisation routine: 
The different parts of the Initialisation routine are: 


see pages 
i. The RAM check. 53 
li. | The setting of the stack marker. 43,51 
ii. | The loading of the | register. 32 
iv. The selection of interrupt mode 1. 92 
v. The loading of the lY register pair. 31 
vi. The selection of ‘slow’ mode. 44 
vii. The building of the basic display file. 71 


as all these different parts of the routine have been used as examples in 
Chapter 4 they will not be discussed further. 

The BASIC line editing routines: 

There are a tremendous number of different routines in this part of the 
monitor program. 

The following list gives the locations of the more important of them. 
However only the routines that are useful to the machine code program- 
mer will be discussed further. 

6454 Cursor down routine 

9482 Build-up an E-line routine 

G4C1 Command point routine 

@52B Editing key sort routine. 

@5C4 Edit routine 
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G63E 
G72C 
@745 
@7BD 
Q7F1 
G8F5 
6918 
G94B 
G@9AD 
O9F2 
GA2A 
GA98 
GACF 
@BAF 
OCOE 


Run BASIC program routine 

LIST command routine 

Print a whole BASIC line routine. 
Keyboard decode routine 

Print a character routine 

Test PRINT AT parameters routine 
Expand Display File routine 

Print keywords routine 

Change all pointers routine 

Next variable or BASIC line routine 
CLS command routine 

Print a decimal number routine 
PRINT command routine 

PLOT and UNPLOT commands routines 
SCROLL command routine 


The routines from this part of the monitor that can easily be used ina 
machine program will now be discussed. Simple BASIC programs will 
demonstrate the routines being used. 


The CLS command routine. 


This is a very simple routine to use. In BASIC in order to clear the screen 
a line such as: 18 CLS is used. When the BASIC interpreter executes 
this line the only action taken is to call the subroutine at OA2A. 

Hence whenever a machine code program contains the instruction 
line: CALL OA2A the screen will be cleared. 

This is shown in the following BASIC program: 


mnemonic Hex. code 
1@ REM 1234 
26 PRINT “PRESS NEWLINE 
TO CLEAR SCREEN” 

36 SLOW 
40 LET A=16514 
5G POKEA,2@5 CALL addr. CD 
6@ POKE A+1,42 2A 
7@ POKE A+2,10 GA 
8G POKE A+3,2@1 RET C9 
9¢ INPUT AS 

100 LETL=USRA 

RUN 


The print a decimal number routine: 

Although the 8K monitor program provides floating-point arithmetic there 
is still the need to have a routine for printing decimal numbers. This 
routine is used to print the contents of the HL register pair as a decimal 
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number using absolute binary arithmetic. The range of numbers printed 
is @ to 9999. 

The routine is used in the monitor program for the printing of the line 
numbers in a listing of a BASIC program. 

The following BASIC program demonstrates the routine. 


mnemonic Hex. code 
10 REM 1234567 
20 SLOW 
30 PRINT AT 18,0;“ENTERA 
VALUE FOR THE HIGH 
BYTE (@-39)” 
40 INPUTH 
50 PRINT AT 18,22;“LOW 
BYTE” ,“(@-255)” 
60 INPUTL 
7@ CLS 
8@ LET A=16514 
90 POKEA,33 LDHL,+dddd 21 
100 POKE A+1,L L 
110 POKE A+2,H H 
120 POKE A+3,265 CALL addr. CD 
1380 POKE A+4,171 AB 
140 POKE A+5,16 0A 
150 POKE A+6,201 RET C9 
16@ PRINT “THAT GAVE”: 
176 LETL=USRA 
18@ RUN 
RUN 


Note how the USR statement cannot this time be included in a PRINT 
statement. 


The PRINT AT routines: 
The BASIC PRINT AT command aliows the user of a ZX-81 to move the 
PRINT position to a specified location. 

e.g.1@ PRINT AT 16, 10 
will lead to the PRINT position being the eleventh space on the eleventh 
line. (do not forget that 9,0 is the top lefthand space) 

When the display file is in a ‘collapsed’ state the use of the PRINT AT 
command results in the display line being expanded if it should be 
necessary. If the specified space already exists in the Display File then 
no expansion is required. 

In the 8K monitor program whenever a PRINT AT command is ex- 
ecuted, the parameters supplied by the programmer are tested in the 
‘test PRINT AT parameters routine’ (see also page 53) and then the 
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‘expand Display File routine’ is called. This second routine tests to see 
whether or not the specified PRINT position already exists in the Display 
File and if it does not, the Display File is expanded so that it does become 


present. 


Both of these routines can be used in machine code programs. The 
following BASIC program gives a very simple demonstration of the 
PRINT position being set by a machine code routine. 


10 
20 


3G 
40 


50 
6d 


76 
8G 
96 
100 
110 
120 
136 
146 
15@ 
166 
176 
186 
RUN 


mnemonic 
SLOW 
PRINT AT 18,¢;“ENTER 
LINE NUMBER (@-16)” 
INPUT L 
PRINT AT 18,0;“ENTER 
COLUMN" 
INPUT C 
PRINT AT 18,0;“ENTER 
YOUR CHARACTER NOW” 
INPUT BS 
LET A= 16444 
POKE A,1 LD BC,dddd 
POKE A+1,C 
POKE A+2,L 
POKE A+3,205 CALL addr. 
POKE A+4,245 
POKE A+5,8 
POKE A+6,201 RET 
LETK=USRA 
PRINT BS 
RUN 


Hex. code 


G1 


CD 
F5 


C9 


In the above program the user is asked to provide the line and column 
parameters, and a character, or string of characters. The machine code 


routine then sets the required PRINT position for line 17@. 


The PRINT a string routine. 
This routine forms part of the ‘PRINT command routine’, and is used in 
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the 8K monitor program whenever a string of characters has to be 
printed. 

The parameters for handling a string are: 

i. The starting address of the string, and 

ii. The number of characters of the string. 

These parameters are passed to the ‘PRINT a character routine’ for 
each of the characters in the string, and this results in each character 
being printed at the current PRINT position. Remember that the ‘PRINT a 
character routine’ increments the PRINT position after the character has 
been printed. 

The following BASIC program shows a string being printed. 


mnemonic Hex. code 
18 REM THIS STRING HAS 
29 CHARACTERS 
20 SLOW 
30 PRINT AT 8,@; 
40 LET A=16444 


56 POKEA,17 LD 11 
DE, +dddd 
60 POKE A+1,13@ 82 
76 POKE A+2,64 4G 
86 POKE A+3,1 LD G1 
BC,+dddd 
9@ POKE A+4,29 1D 
160 POKEA+5,@ GG 
116 POKE A+6,205 CALL addrCD 
128 POKE A+7,107 6B 
13@ POKE A+8,11 6B 
146 POKE A+9,201 RET C9 
15@ LETL=USRA 
RUN 


‘In the above program the DE register pair is loaded with the starting 
address of the string — decimal 16514, Hex. 4082, and the BC registers 
pair is loaded with the number of characters in the string — decimal 29, 


Hex. 01D. } 
The PLOT and UNPLOT commands routine. 


This routine is used in a very similar way to the ‘PRINT AT routine. 

Initially therefore the parameters passed to the routine are tested to 
ensure that they are within the correct range. 

A test is then made to see if the operation should be a PLOT or an 
UNPLOT. This test is performed by comparing the value of T-ADDR, the 
system variable that holds the address of the next item in the syntax 
table, against the address in that table for the UNPLOT command. 

The following lines show the actual test. 
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address Hex. code mnemonic comment 


O@BDA 119E OC LD DE,+@C9E UNPLOT 
address in table. 
BDD 3A 30 4G LD A,(T-ADDR) Pick-up 
| T-ADDR. 
BEG 93 SUB E Test low bytes. 
BE1 FAE9@B JP M,@BE9 Jump for PLOT 


BE4..... continue with UNPLOT. 


The following BASIC program shows how the operations of PLOT and 
UNPLOT can be included in a machine code routine. 


mnemonic Hex. code 
16 SLOW 
2G PRINT AT 18,0;“ENTER X 
PIXEL NUMBER (G@-63)” 
30 INPUT X 
4@ PRINT AT 18,6;“Y PIXEL 
NUMBER (1G6-43)” 


50 INPUT Y 
66 PRINT AT 18,0;“ENTER PLOT 
OR UNPLOT (P/U)” 

7@ INPUT BS 

80 LET A=16444 

90 POKEA,1 LDBC,dddd 01 
10@ POKE A+1,X X 
110 POKE A+2,Y Y 
126 POKE A+3,62 LD A,dd 3E 
13@ POKE A+4,102+CODE . 
BS 9B or AO 
140 POKE A+5,5@ LD (addr.), A, 32 
150 POKE A+6,48 (T-ADDR) 30 
166 POKE A+7,64 ( ) 40 
170 POKE A+8,205 CALL addr. CD 
180 POKE A+9,178 B2 
19@ POKE A+16,11 OB 
20@ POKE A+11,201 RET C9 
210 LETK=USRA 
220 RUN 
RUN 


In the above program the user is asked to provide valid parameters for 
X and Y, and then to specify PLOT or UNPLOT. The value stored as the 
low byte of T-ADDR is then compared to the constant Hex.9E to disting- 
uish whether the operation is to be a PLOT or an UNPLOT. 
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The BASIC command tables: 
The first table in this part of the monitor program is the table of ‘offsets’ 
that is used to index into the ‘syntax’ table. 

The offset table’ is at OC29 — 0C47, and the ‘offsets’ for the different 
BASIC commands can be shown by using the following BASIC program. 


186 SLOW 
26 FORA=1TO2 
30 PRINT “COMMAND OFFSET”; 
40 NEXTA 
5@ PRINT 
6@ PRINT 
76 LET B=8 
80 FOR A=225 TO 255 
96 PRINT CHRS A;TAB (16-B); 
PEEK (2888+A), 
100 LETB=-B 
11@ NEXTA 
RUN 


The other table in this part of the monitor program is the ‘syntax’ table. 

This table gives the command class for each part of the command, the 
character code for the required syntactic separator, if one is required, 
and the address of the command routine. 

e.g. The entry for PLOT is: 


GC98 G6 The command class. 
@C99 1A The separator, a ‘comma’. 
GC9A G6 The command class. 
GC9B GG The command class. 


G@COC AF ) The PLOT routine is at 
GC9D G8 ) OBAF which determines 
thata PLOT commandline 
| must have the syntax; 
PLOT (expression) (,) 
(expression) as in 
PLOT @,@ 


The following table gives the command routine addresses as can be 
obtained from the table. 
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Command routine 


Address Command address 
0C48 LET (not in table but 
it is 131D) 
0C4B GOTO GE81 
GC4F IF GDAB 
GC54 GOSUB GEBS5 
GC58 STOP @CDC 
GC5B RETURN GED8 
G@C5E FOR @DB9 
0C66 NEXT GE2E 
OC6A PRINT GACF 
@C6D INPUT GEES 
0C71 DIM 1405 
0C74 REM @D6A 
0C77 NEW G3C3 
GC7A RUN GEAF 
GC7D LIST 6730 
0C80 POKE GE92 
06C86 RAND GE6C 
gC89 LOAD 0340 
6C8C SAVE Q2F6 
OC8F CONT GE7C 
@C92 CLEAR 1496 
@C95 CLS GA2A 
@C98 PLOT GBAF 
O@C9E UNPLOT O@BAF 
G@CA2 SCROLL GCGE 
@CA7 PAUSE QF2F 
@CAB SLOW GF28 
@CAE FAST GF2G 
0CB1 COPY G869 
GCB4 LPRINT GACB 
0CB7 LLIST G72C 


The BASIC line scanning routine. 

This part of the 8K monitor program is the real BASIC interpreter. It is in 
this routine that each BASIC line is scanned and actions determined that 
are needed to execute that line. 

As a BASIC line is scanned each command is identified. The com- 
mand class for that command is obtained from the syntax table and a call 
made to the appropriate command class routine. 

The different classes are used to show the differing syntactic require- 
ments of the commands. 

e.g. The STOP command is in class @, as it is a command that cannot 


123 


be followed by any parameters. Whereas PLOT is put into class 6 on two 
occasions, as the PLOT command is required to be followed by two 
expressions separated by a ‘comma. 


The BASIC command routines: 
Each of the BASIC commands has a command routine in the 8K monitor 
program. Most of the routines are to be found in this block of the program. 
The addresses for all of the routines are to be found in the table on page 
123. | 

The majority of the routines are too complicated to be discussed, but it 
is worth looking at the FAST command routine and the SLOW command 
routine as these routines can be used by the machine code programmer. 


The FAST command routine: 
The full routine is: 


address Hex. code mnemonic comment 
GF20 CD E7 G62 CALL 02E7 See below. 
F23 FDCB3BB6 RES6,(403B) Reset the Flag. 
F27 C9 RET Finished. 
G2E7 FDCB3B7E_ BIT 7,(403B) FAST already? 
2EB C8 RET Z Yes 
2EC 76 HALT No. So wait 
interrupt. 
2ED D3 FD OUT (+FD),A Tothelogicchip. 
2EF FDCB3BBE RES/7,(403B) Reset the other 
flag. 
2F3 C9 RET Finished. 


In a machine code program the programmer wishes to change to 
FAST mode, or to ensure that he is in FAST mode, then it can be done 
simply by using: CALL OF 20. 

The SLOW command routine: 
The routine is only: 


address Hex. code mnemonic comment 
OF28 FDCB3BF6 SET6,(403B) Set the flag. 
F2C C307 G2 JP 0207 Jump to display 
routine. 


This routine can be called using: CALL OF28. 


The BASIC expression evaluator and the floating-point routines. 
These parts of the 8K monitor program are very complicated and 
cannot be used by a machine code programmer. 
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The character generator: 
The following BASIC program can be used to show the 64 different 
characters in the ‘character generator’, each enlarged 64 times. 


1@ FAST 
26 FOR A=7686 TO 8184 STEP 8 
3G PRINT “ADDRESS CONTENTS CHARACTER” 
4¢ PRINT AT Siu 
50 FOR B=ATOA+7 
6@ LET C=PEEKB 
7@ PRINT B;TAB 8;C;TAB 17;"""; 
8@ LET D=128 
96 FORE=@TO7 
160 IF C>D—1 THEN GOTO 136 


110 PRINT“ ”; (space) 
126 GOTO 15@ 
13@ PRINT “a’; | (graphic space) 


149 LETC=C-D 

150 LETD=D/2 

160 NEXTE 

176 PRINT“ *” 

180 NEXTB 

190 PRINT AT 12,17;"***t***"**" 
200 PAUSE 150 

210 CLS 

220 NEXTA 

RUN 
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Chapter 7. Using Machine Code 
Routines in BASIC Programs. 


7.1 introduction 


The main purpose of using machine code routines within a BASIC 
program is to produce a final program that runs considerably faster than 
the original program. 

It is rarely practical to completely replace the whole of a BASIC 
program with a single machine code program in the ZX-81 system using 
the standard 8K ROM. The main problem being that there is not a 
particular subroutine in the 8K monitor program for handling the ‘INPUT 
command’. Therefore most programmers write machine code routines 
for the slow parts of their programs and return to BASIC whenever an 
‘INPUT is required. 

The resultant program could therefore be of the form: 


1@ REM xxxxxxxxxxxxxXxxXxXxxXxx ) the machine code. 
XXXXXXXXAXXXAXXAXXAXAXXAXXAXAXXXX  ) routines. 


20 LET K=USR 16514 Execute the first routine. 
30 INPUT A Return for INPUT. 

46 POKE 16530,A Store the INPUT. 

5@ LET K=USR 16531 Execute the next routine. 
RUN 


The rest of this chapter takes the reader through the actual stages in 
producing ‘machine code routines’. 


7.2 The stages involved. 


The first stage is the ‘writing of the BASIC program’. 

It is usually a very good idea to produce a BASIC program that actually 
performs the required task. Of course the program may run very slowly 
but at least the programmer has the opportunity to make changes reia- 
tively easily. 

The second stage is the ‘deciding which part of the program is to be 
converted to machine code’. 

This stage involves determining which set of BASIC lines are to be 
replaced by a: LET K=USR xxxxx and also which parameters are 
required by the machine code routine, on entry; and which parameters 
are to be returned by the routine. 

The third stage is the ‘producing of a listing of the machine code routine 
in assembler format’. | 
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This stage is usually the most difficult as it involves the conversion of 
the original algorithm to one that uses the rather limited number of 
registers within the Z80. The programmer also has to consider which 
instructions in the Z80 instruction set actually exist, and the ‘construc- 
tions involved for those operations that are not suported by the Z80. 

e.g. There is no instruction — LD B,(addr.) and the usual construction 
to perform this would be — LD A,(addr.) LD B,A but this disturbs the A 
register. An alternative construction would be — LD BC,(addr.—1) but 
this disturbs the C register and a third construction would be — LD 
HL,+dddd (address) LD B,(HL) that disturbs the HL register pair. 

The fourth and final stage is the ‘assembling of the machine code 
routine’. 

This stage involves the actual production of the appropriate Hex. code 
or decimal code for the routine. The location of the program in the RAM 
will usually affect this operation. 

A machine code routine that can be placed at any point in the RAM 
because it does not contain any absolute addresses is said to be ‘relocat- 
able’. However most routines do contain absolute addresses and there- 
fore must be ‘located’ in a particular part of the RAM. 

The following examples show these stages in detail. 


7.3 The first example — The Sum of a Series. 


This example was briefly discussed on pages 99 & 100 but the stages 
involved in producing the machine code routine were not dealt with in 
detail. 

The following BASIC program asks the user to enter an integer in the 
range 1-255 and then produces: THE SUM OF THE SERIES 
0+1+2+...N = xxx. 

Stage 7. 
The program for this general case Is: 
26 SLOW 
3@ PRINT AT 18,0;“ENTER A VALUE 
FOR N (1-255)” 
40 INPUTN 
50 CLS 
6@ PRINT “THE SUM OF THE SERIES™ 
7@ PRINT AT 2,2;°@+1+2+...°:N;° ="; 
80 LET SUM=@0 
90 FORK=NTO@ STEP -1 
16@ LET SUM=SUM+K 
110 NEXTK 
12@ PRINT SUM 
13@ RUN 


127 


This program satisfies the requirement of ‘stage 1’ in that a working 
BASIC program has been produced. 

Notice how the program has been written. 

It is obviously going to be desirable to replace lines 80-110 with 
machine code, therefore these lines have been written like a ‘subroutine’ 
at the end of the program. Note also how the ‘FOR. . .NEXT’ loop goes 
from ‘255. . .to. . .@’ which will make it very easy to convert it to a DINZ 
instruction. 

The more ‘machine code features’ that are included in the BASIC 
program, then generally the easier it will be to convert the program to 
machine code. 


Stage 2. 
In this simple example program it is lines 80-110 that are going to be 
replaced by a machine code routine. 

The variable N, range 0-255, is the only parameter required by the 
routine, and the variable SUM is the only parameter returned by the 
routine. In this case the lines: 


8G POKE 16514,N 
9¢ PRINT USR 16515 


can be used to replace lines 80-120. 

It is useful at this stage to produce a flow diagram of the actual lines 
that are to form the machine code routine. 

A possible flow diagram is: 


comment 


Start with N brought in. 


Zero the answer. 
AFOR...NEXT loop, 


FORK=NTO@ STEP -1 
NEXT K 


Increase the answer. 


Finish the subroutine 
and return the variable 





Stage 3. 
The first task in this stage is to make a start at allocating ‘registers’ or 
‘memory locations’ to the various variables. 

The flow chart developed for stage 2 shows that the FOR. . NEXT 
loop box is central to the flow diagram. Hence it would be sensible to 
assign a register to the loop counter K. 

in this example the B register used in conjunction with a DJINZ instruc- 
tion can very easily be used as a loop counter. 

The FOR. . .NEXT loop box can now be redrawn as: 
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Note that the B register has to be initialised to the value of N. 

There are many ways of dealing with the variable SUM but probably 
the most simple method is to allocate the HL register to this variable. 

Initially HL will have to be zeroed, and at the end of the routine the 
contents of the HL register will have to be copied into the BC register for 
returning as the USR variable. 

Note that the BC register pair cannot be used to hold SUM throughout 
the routine as the B register has already been used. 

The operation of ‘SUM=SUM-+K' is not possible directly as there is no 
instruction ‘ADD HL,B’ therefore a ‘construction’ has to be considered. 
As there is a suitable instruction ‘ADD HL,DE’ it would be quite sensible 
to use it and to copy the contents of B into E before the addition operation. 
However the D register must be zeroed at the start of the routine. 

The last point to be made is that a ‘construction’ must be used for the 
initialising of the B register to hold the variable N. 

The use of: LD A,addr. and LD B,A is quite appropriate. 

The full flow chart now becomes as follows. The mnemonics are also 
given: 







mnemonics 


LD HL, +dddd 
LD A,(addr.) 
LD BA 
LD D,+dd 


Finished 


LDE,B 
ADD HL,DE 
DJNZe 


Stage 3 requires that a listing of the final machine code routine be 
given in ‘assembler format’, and therefore the routine becomes: 


Stage 4 


Label 
START 


mnemonic 
LD A,(N) 

LD B,A 

LD HL,+0000 
LD D,+00 
LDE,B 

ADD HL, DE 
DJNZ LOOP 
LD B,H 

LD C,L 

RET 


LOOP 


END 


The variable N is going to be POKEGd into location 16514 and the routine 
located from 16515 onwards. The ‘assembled’ routine will be: 


address. 


dec. 

16514 
16515 
16516 
16517 
16519 
16520 
16521 
16522 
16523 
16524 
16525 
16526 
16527 
16528 
16529 
16530 


Hex. 

4082 
4083 
4084 
4085 
4087 
4088 
4089 
408A 
408B 
408C 
408D 
408E 
408F 
4090 
4091 

4092 


Hex. code Dec. code label 
N 


3A 58 START 
82 130 

40 64 

21 33 

00 G 

00 G 

16 22 

00 G 

58 88 LOOP 
19 25 

10 16 

FC 252 

44 68 

4D 77 

C9 201 END 
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mnemonic 
LD A,(N) 
LD A,(N) 


LD HL, +0000 


LD D,+00 


LDE,B 
ADD HL,DE 
DJNZ LOOP 


LD B,H 
LDC,L 
RET 


The table shows that the final routine uses 17 locations. 
Now comes the moment of truth. Enter the following BASIC lines: 


10 REM 1234567896 1234567 The 17 locations. 

26 SLOW 

30 PRINT AT 18,0;“ENTER A VALUE 
FOR N (1-255)” 

40 INPUTN 

50 CLS 

6@ PRINT “THE SUM OF THE SERIES” 

76 PRINT AT 2,2;°04+1+2+...°3N5° ="; 

8@ POKE 16514,N 

9@ PRINT USR 16515 

160 RUN 


Do not RUN the program until you have entered the machine code 
routine into line 1@. 
A useful method of ‘loading machine code’ is as follows: 
Enter: 
200 FOR A= 16515 TO 16530 
210 INPUT B 
220 POKE A,B 
230 NEXT A 
RUN 206 
This routine is RUN and the decimal code entered. In this case it is: 
58, 130,64,71,33,00,22,0,88,25,16,252,68,77,201. 
Note that location 16514 is left to be filled by the BASIC program. 
Once the machine code has been entered, delete lines 200-230 and 
enter RUN. 
Although this program is only very simple, there is an impressive 
change in the response times, when compared to the BASIC-only 
version. 


7.4 The second example — A Moving Ball Program. 


This example is a good deal more complicated than the first example but 
it has been included as it shows how a complicated program can be 
tackled. 


Stage 7. 

The BASIC program is: 
26 SLOW 
34 CLS 


46 GOSUB 160 
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5@ FOR A=1 TO 16 
60 PRINT AT A,@;“M@”; AT A,18;m” graphic space 
70 NEXTA 
80 GOSUB 100 
98 GOTO 140 
160 FOR A=@ TO 18 
110 PRINT “mm”; graphic space 
120 NEXTA 
130 RETURN 
14@ LET LR=1 
150 LET UD=1 
166 LET X=2 
17@ LET Y=INT (RND*32+ 10) 
18@ PLOT X,Y 
190 IF INKEY $=“R” THEN RUN 
200 IF X=2 OR X=35 THEN LET LR=—LR 
210 IF Y=16 OR Y=41 THEN LET UD=—UD 
220 UNPLOT X,Y 
230 LET X=X-—LR 
240 LET Y=Y—UD 
250 GOTO 186 
RUN 


The lines 20-130 draw a rectangular playing area. The use of a 
temporary line ‘135 STOP’ can be used to show this being done. 

Lines 14@ and 154 initialise the ‘direction’ of the ball. LR is the variable 
for ‘Left and Right’, +1 is for moving right and —1 is for moving left. UD is 
the variable for ‘Up and Down’, +1 is for moving up and — 1 is for moving 
down. 

Lines 16@ and 17@ give initial values to the X and Y variables used in 
the PLOT command. The value for X is fixed but the value for Y is chosen 
at random. 

Line 19@ allows the user to restart the program. | 

Lines 200 and 21G test the position of the ball and if it is against an 
edge the direction of the ball is reversed. 

Line 220 erases the position that was filled in line 18d. 

Lines 23@ and 24G give new values for X and Y so that the ball moves. 


Stage 2. 
The functional flow diagram for this program could be: 
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SLOW mode 


Print 
rectangle 
Choose Y 
parameter 


Choose other 
parameters 


MOVE BALL 


















pressed? 


Yes 


It is possible to write machine code, of quite a simple nature, for all of 
the functional blocks of this program with the exception of the ‘Choose Y 
parameter’ block. This block uses the BASIC RND command for which 
there is no readily useable subroutine. (The RND command produces a5 
byte floating-point number). 

A suitable plan for the final BASIC program would be: 


16 REM xxxxxxxxx ete. The machine code. 
20 LET K=USR xxxxx ( SLOW mode 
(CLS 


( Print rectangle 
3@ POKE xxxxx, INT(RND*32+1@) (Choose Y parameter. 
4G LET K=USR xxxxx (Choose other parameters. 
(MOVE BALL 
(Is ‘R’ pressed?) 


50 RUN 
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However further consideration should be given to ‘exiting’ from the 
program. When a BASIC program is being executed the BREAK key is 
tested after each BASIC line has been dealt with, but ina machine code 
routine the BREAK key will be inactive unless special provision is inc- 
luded in the routine. In this example, therefore, the keys ‘R’ and ‘BREAK’ 
shouid be tested. 

The flow diagrams for the two machine code routines are as follows: 

The first machine code routine: The second machine code routine: 















Y 
Start with Y availab 
CALL ‘SLOW’ 
CALL CLS 
UD=1 
CALL LINE 
X=2 








Enter the ball 


The ‘LINE’ subroutine. 





Yes 


UD=—-UD} Reverse the ball 





or 
=41? 


ja s : 


3 


UNPLOT X,Y Erase the ball 
X=X+LR Update the positior 
Y=Y+UD Update the positio 
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Stage 3: 
The first machine code routine; 

It is usually easiest to start with the subroutines and then return to the 
main routine. 

The subroutine ‘LINE’ is a very simple printing operation that prints 
nineteen identical characters. The use of a DJNZ instruction is most 
appropriate. The ‘assembler format’ listing for this subroutine is 
therefore: 


Label mnemonic comment 
LINE LD A,+80 An inverse space. 
LDB,+13 The nineteen 
characters. 
NEXT RST 0010 Print a character. 
DJNZ NEXT Go back. 
RET Finished. 


In the main routine the first two CALLs are to routines within the 8K 
monitor program and the ‘assembler format’ listing for the routine, except 
for the ‘print edges’ block will be: 


Label! mnemonic 
START CALL SLOW 
CALL CLS 
CALL LINE 
EDGES 9 -shetieailaseeeaena: 
CALL LINE 
RET 


The conversion of the ‘print edges’ block is a little complicated. How- 
ever it can be performed in simple stages. 

The method discussed on page 130 for the first example program, 
involved drawing a flow diagram where each block corresponded to a 
machine code instruction. However there is an alternative method that 
involves the production of a routine of BASIC lines, with each line having 
a corresponding machine code instruction. 

This second method is demonstrated using the three lines of the ‘print 
edges block. 


135 


The original lines are: 
5@ FOR A=1 TO 16 
6@ PRINT AT A,@;“@”"; AT A,18;“m@” 
76 NEXTA 


As a first step the loop counter should be reversed, as the final 
machine code routine will use a DJNZ instruction to operate the looping 
operation. 

Next the ‘PRINT AT’ command should be split into smaller parts. 

The routine will now be: 


50 FOR B=16 TO 1 Note B is used 
STEP —1 

54 PRINT AT 17—B,@: 

58 LET A=128 Note A is used. 


62 PRINT CHRS A 

66 PRINT AT 17—B, 18; 
7@ LET A=128 

74 PRINT CHRS A 

78 NEXT B 


Note how variable names that are also used as register names are 
being employed whenever the register is appropriate. 

The ‘PRINT AT command routine’ uses the B register to hold the ‘line 
number’ and the C register to hold the ‘column number’ (see page 118), 
and this point should now be included. However this will lead to B being 
used twice unless the first value for be is saved. The stack is a suitable 
place to save the contents of the B register, hence the variable STACK 
can be used. 

The routine now becomes: 


comment 
5@ FOR B=16 TO 1 STEP —1 
52 LET STACK=B Save B temporarily. 
54 LET B=17-B Re-define B, — Line. 
56 LET C=6 Define C, — Column. 
58 PRINT AT B,C; 
6@ LET A=128 Print the ‘inverse space’. 
62 PRINT CHRS A 
64 LET B=STACK Collect B. 
66 LET B=17-B Re-define B, — Line. 
68 LET C=18 Define C, — Column. 
7@ PRINT AT B,C; 
72 LET A=128 Print the ‘inverse space’. 
74 PRINT CHRS A 
76 LET B=STACK Restore B. 
78 NEXT 8B Next line. 
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The last stages involve the splitting of the ‘B=17—B’ and the balancing 
of the lines involving the stack. This point is very important in machine 
code as the moving of data onto or off the stack will change the value of 
the stack pointer. In BASIC however there is no such problem. 

The result is that the line: 64 LET B=STACK must be followed by a 


line: 65 LET STACK=B. 
The routine now becomes: 


EDGES 50 FORB=16T0O1 STEP —1 
51 LET STACK=B 


92 LET A=17 
53 LET A=A-B 
54 LET B=A 
56 LET C=@ 


58 PRINT AT B,C; 


60 LET A=128 


62 PRINT CHRS A 
64 LET B=STACK 
65 LET STACK=B 


66 LET A=17 
67 LET A=A-B 
68 LET B=A 
69 LET C=18 


70 PRINT AT B,C; 


72 LET A=128 


74 PRINT CHRS A 
76 LET B=STACK 


78 NEXT B 


mnemonic that corresponds. 
LD B,+dd 
PUSH BC 

LD A,+dd 

SUB B 

LDB,A 

LD C,+dd 

CALL PRINT AT 
LD A,+dd 

RST 0010 

POP BC 

PUSH BC 

LD A,+dd 

SUB B 

LDB,A 

LD C,+dd 

CALL PRINT AT 
LD A,+dd 

RST 0010 

POP BC 

DJNZ LINE 51 


The routine now has its ‘one-to-one’ correspondence but it can be 
improved by re-writing it using a subroutine. It becomes: 


EDGES 5@ FORB=16TO1STEP —1 LDB,+dd 


591 LET STACK=B 


52 LET C=@ 
53 GOSUB 76 


54 LET B=STACK 
95 LET STACK=B 


56 LET C=18 
97 GOSUB 76 


08 LET B=STACK 


99 NEXT B 
6@ STOP 


137 


PUSH BC 

LD C,+dd 
CALL SQUARE 
POP BC 

PUSH BC 

LD C,+dd 
CALL SQUARE 
POP BC 

DJNZ LINE 51 


SQUARE 7@ LET A=17 LD A,+dd 


71 LET A=A-B SUB B 

72 LET B=A LDB,A 

73 PRINT AT B,C; CALL PRINT AT 
74 LET A=128 LD A,+dd 

75 PRINT CHRS A RET 0010 

76 RETURN RET 


Before the actual listing is given there is just one further point to be 
made. 

The ‘CALL LINE’ subroutine that forms the bottom line of the rectangu- 

lar playing area requires that the PRINT position be moved to the start of 
a new line, after the last edge square has been drawn. 
This can be produced by using the ‘RET 0010’ instruction to PRINT a 
NEWLINE character. However it is not totally straightforward as the 
value 118, Hex.76, cannot be used in a REM statement. The following 
construction is therefore needed. 


Label mnemonic 
NEWLINE LD A,+75 
INCA 
RST 0010 


The ‘assembler format’ listing for the whole of the first machine code 
routine can now be given. 


Label mnemonic comment 
LINE LD A,+8G@ Inverse space. 
LD B,+13 19 characters. 
NEXT RST 0014 
DJNZ NEXT 
RET 
SQUARE LDA,+11 Decimal 17. 
SUB B 
LDB,A 
CALL PRINT AT In monitor at @8F5. 
LD A,+8@ 
RST 6014 
RET 
START CALL SLOW In monitor at @F28. 
CALL CLS In monitor at @A2A. 
CALL LINE 
EDGES LD B,+10 16 rows, numbers 1 to 
ROW PUSH BC 16. 
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LDC,+@0¢4 Column @. 
CALL SQUARE 
POP BC 
PUSH BC 
LDC,+12 Column 18. 
CALL SQUARE 
POP BC 
DJNZ ROW 
NEWLINE LDA,+75 
INCA Form Hex.76. 
RST 001G 
CALL LINE 
RET 


The above routine may appear initially to be rather awkward but when 
assembled into machine code and run, even in ‘slow’ mode the playing 
area is produced in 0.4 seconds. 

The reader may if he wishes turn to page 148, enter this routine and 
see it working, before returning to deal with the second machine code 
routine (use 210 FOR B=16514 TO 16567 and LET K=USR 16514). 


The flow diagram for this routine, given on page134 , shows that the first 
task is to initialise the variables LR, UD and X. 

There are many ways in which variables such as these could be 
handled in a machine code routine, but the simplest way is to allocate a 
memory location to each variable, and label the locations appropriately. 


The ‘assembler format’ listing for this part of the routine could therefore 
be: 


Label mnemonic comment 
UD — 
LR — 
x = 
Y — Filled from BASIC. 
VALUES LDA,+@1 
LD (UD),A 
LD (LR),A 
INCA The A register now 
holds Hex. @2. 
LD (X),A 


The next stage is to deal with the ‘PLOT X,Y’ operation. The example 
program on page 121 shows how this operation can be performed. 
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The steps are: 

i. Load the BC register pair with X and Y. The X value going to the C 
register and the Y value going to the B register. 
This will simply be: PLOT LD BC,(X). Note that this instruction will be a 
‘register pair loading instruction, with X going to C, and Y going to B. 
ii. Set the system variable, T-ADDR to ‘PLOT’. This will be the same as 
on page 121. 

LD A,+9B a suitable constant. 

LD (T-ADDR),A 
lii. Call the ‘PLOT command routine’. 

CALL PLOT command routine. 

The ‘is R or BREAK pressed?’ operation is also fairly simple. 

A cail to the ‘keyboard scanning routine’ returns a key value in the HL 
register pair. This value has then to be tested to see whether it is a ‘NO 
KEY’, an ‘R’ or a ‘BREAK’. 

The following BASIC lines show just one possible way of performing 
this operation. 


comment 
16 LET HL=-1 —1is ‘no key’, 
61435 would be 'R’. 
64895 would be ‘BREAK’. 
(these values are given in appendix iv.) 


26 LET DE=HL Exchange registers. 

36 LET HL=61435 Set HL to hold key value for ‘R’. 
40 LET HL=HL-DE Test for ‘R’. 

50 IF HL=@ THEN RETURN ‘RET 2’ 

60 LET HL=64895 Key value for ‘BREAK’. 

7@ LET HL=HL—DE Test for ‘BREAK’. 

8@ IF HL=@ THEN RETURN ‘RET 2’. 


96 PRINT “NO KEY PRESSED” 


The reader might like to try this little program with different values in 
line 10. An ‘ERROR 7’ is obtained when a match is found, otherwise the 
‘NO KEY PRESSED’ message is given. 

These BASIC lines can now be converted to give an ‘assembler 
format’ listing. Note however that ‘AND A’ instructions must be used to 
clear the Carry flag before each subtraction. 


Label mnemonic comment 

KEY TEST CALL KEYBOARD _ Inmonitor at @2BB. 
EX DE,HL 
LD HL,+EFFB Key value for ‘R’. 
ANDA 
SBC HL,DE 
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RET Z Return if ‘R’ pressed. 


LD HL,+FD7F Key value for ‘BREAK’ 

ANDA 

SBC HL,DE 

RET Z Return if ‘BREAK’ 
pressed. 


An alternative to the above method would be to signal an ‘ERROR’ 
when the ‘BREAK ' key is pressed. This can be done using an ‘RST 0068’ 
instruction. 

The testing of the X value can be considered as the following BASIC 
lines 


10 LET LR=1 Define LR. 

20 LET X=12 Define X to a suitable value. 
30 LET A=X LD A,(X) 

40 IF A=2 THEN GOTO 60 Test against 2. 

5@ IF A<>35 THEN GOTO 86 Test against 35. 

60 LET A=LR LD A,(LR) 

70 LETLR=—LR 2's complement LR. 


80 REM CONTINUE 


The testing of the Y value will be similar, as only the constants and 
variables are changed. 

Note that as the values of LR and UD change from +1 to —1 itis the 2's 
compiement of LR and UD that have to be found if a match occurs. 

The ‘assembler format’ listing for the two test routines will be: 


Label mnemonic 
X-TEST LD A,(X) 

CP +@2 

JR Z,LR-REV 

CP +23 

JR NZ,Y-TEST 
LR-REV. LD A,(LR) 

CPL 

INCA 

LD (LR),A 
Y-TEST LD A,(Y) 

CP +GA 

JR Z,UD-REV. 

CP +29 

JR NZ,UNPLOT 
UD-REV. LD A,(UD) 

CPL 

INCA 

LD (UD),A 
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The UNPLOT operation is the same as the PLOT operation but the 
constant loaded into T-ADDR has to be altered. 


Label! 
UNPLOT 


mnemonic 


LD BC,(X) 
LD A,+A@ 


LD (T-ADDR),A 
Call Plot command 


routine. 


The final operation is the updating of X and Y. Once again there are 
many ways in which this can be done and the following listing shows a 


method that uses ‘indirect addressing’. 


mnemonic 
LD HL,+LR 


Label 
X-UPDATE 


Y-UPDATE 


LD BC,+X 
LD A,(BC) 
SUB (HL) 
LD (BC),A 
DEC HL 
INC BC 
LD A,(BC) 
SUB (HL) 
LD (BC),A 
JR PLOT 


comment 
address of LR. 
address of X. 
collect X. 
X=X—-—LR. 
restore X. 
move to UD. 
move to Y. 
collect Y. 
Y=Y-UD 
restore Y 
‘GOTO 180’ 


Note that this being the final part of the routine a ‘JR PLOT’ is now 


required. 


The whole listing for the second machine code routine can now be 


given. 


Label 
UD 

LR 

x 

Y 
VALUES 


PLOT 


KEY TEST 


mnemonic 


LDA,+01 
LD (UD),A 
LD (LR),A 
INCA 

LD (X),A 
LD BC,(X) 
LD A,+9B 


LD (T-ADDR),A 
CALL PLOT c.r. 


comment 


) 4 locations for 
) the variables. 


Location Hex. 4030. 
Location Hex. @BB2. 


CALL KEYBOARD _Location Hex. @2BB. 
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X-TEST 


LR-REV. 


Y-TEST 


UD-REV 


UNPLOT 


X-UPDATE 


Y-UPDATE 


EX DE,HL 

LD HL,+EFFB 
AND A 

SBC HL,DE 
RET Z 

LD HL,+FD7F 
ANDA 

SBC HL,DE 
RET Z 

LD A,(X) 

CP +62 

JR Z,LR-REV. 
CP +23 

JR NZ,Y-TEST 
LD A,(LR) 
CPL 

INCA 

LD (LR),A 
LDA,(Y) 

CP +0A 

JR Z,UD-REV 
CP +29 

JR NZ,UNPLOT 
LD A,(UD) 
CPL 

INCA 

LD (UD),A 

LD BC,(X) 

LD A,+A@ 

LD (T-ADDR),A 
CALL PLOT c.r. 
LD HL,LR 

LD BC,+X 

LD A,(BC) 
SUB (HL) 

LD (BC),A 
DEC HL 

INC BC 

LD A,(BC) 
SUB (HL) 

LD (BC),A 

JR PLOT 
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‘R' key. 


‘BREAK ' key. 


Lefthand side. 
Righthand side. 


Reverse the ball. 


Bottom of area. 
Top of area. 


Reverse the ball. 


Erase the ball 


Really ‘UNPLOT c.r.’ 
New X value. 


New Y value. 


Round again. 


Stage 4 


The ‘assembled’ routine will be: 
THE FIRST MACHINE CODE ROUTINE 


address. 


dec. 


16514 
16515 
16516 
16517 
16518 
16519 
1652@ 
16521 
16522 
16523 
16524 
16525 
16526 
16527 
16528 
16529 
16536 
16531 
16532 
16533 
16534 
16535 
16536 
16537 
16538 
16539 
16540 
16541 
16542 
16543 
16544 
16545 
16546 
16547 
16548 
16549 
1655¢ 


Hex. 


4082 

4083 

4084 

4085 
4086 
4087 
4088 
4089 
408A 
408B 
468C 
468D 
408E 
408F 
4090 
4091 

4092 
4093 
4094 
4095 
4096 
4097 


4098 


4099 
409A 
409B 
409C 


409D 


409E 
409F 
4GAG 
4GA1 
4QA2 
4GA3 
40A4 
4GA5 
40A6 


Hex. Dec. Label 
code code 

3E 62 LINE 
80 128 

06 6 

13 19 


D7 215 NEXT 


10 16 
FD 253 
C9 261 


SE 62 SQUARE 


11 17 
90 144 
47.71 
CD 205 
F5 245 
g8 8 
3E 62 
86 128 
D7 215 
C9 201 


CD 205 START 


28 8640 
@F 15 
CD 205 
2A «42 
GA 10 
CD 205 
82 130 
40 64 


06 6 EDGES 


10 16 
C5 197 ROW 
GE 14 
ao G 
CD 205 
8A 138 
40 «64 
C1 193 
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mnemonic 
LD A,+80 
LD B,+13 


RST 0010 
DJNZ NEXT 


RET 
LD A,+11 


SUB B 

LD B,A 

CALL PRINT AT 
LD A, +86 

RST 6010 


RET 
CALL SLOW 


CALL CLS 


CALL LINE 


LD B,+1@ 


PUSH BC 


LDC,+0@ 


CALL SQUARE 


POP BC 


16551 
16552 
16553 
16554 
16555 
16556 
16557 
16558 
16559 
16566 


16561 
16562 
16563 
16564 
16565 
16566 
16567 


address. 


dec. 


16568 
16569 
16570 
16571 
16572 
16573 
16574 
16575 
16576 
16577 
16578 
16579 
16586 
16581 
16582 
16583 
16584 
16585 
16586 
16587 
16588 


4GA7 
40A8 
4GA9 
4GAA 
40AB 
40AC 
40AD 
4GAE 
4GAF 
40BG0 


40B1 
40B2 
40B3 
40B4 
40B5 
40B6 
40B7 


117 

60 
215 
205 
136 

64 
201 


NEW 
LINE 


PUSH BC 
LDC,+12 


CALL SQUARE 
POP BC 

DJNZ ROW 
LDA,+75 
INCA 


RST 6016 
CALL LINE 


RET 


THE SECOND MACHINE CODE ROUTINE 


Hex. 


40B8 
40B9 
40BA 
40BB 
46BC 
40BD 
40BE 
40BF 
40CG 
40C1 

46C2 
40C3 
40C4 
46C5 
40C6 
40C7 
46C8 
40C9 
4GCA 
40CB 
40CC 


Hex. Dec. 


code code Label 


SE 
G1 
32 
B8 
40 
32 
B9 
40 
3C 
32 
BA 
4@ 
ED 
4B 
BA 
40 
SE 


62 
1 
50 
184 
64 
50 
185 
64 
60 
5G 
186 
64 
237 
75 
186 
64 
62 


UD 
LR 
X 
Y 


VALUE 


PLOT 
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mnemonic 


~LDA,+01 


LD (UD),A 


LD (LR),A 


INC A 
LD (X),A 


LD BC,(X) 


LD A,+9B 


16589 
16590 
16591 
16592 
16593 
16594 
16595 
16596 


16597 
16598 
16599 
16606 
16661 
16602 
16603 
16604 
16605 
16606 
16607 
16608 
16609 
16616 
16611 

16612 
16613 
16614 
16615 
16616 
16617 
16618 
16619 
16626 
16621 

16622 
16623 
16624 
16625 
16626 
16627 
16628 
16629 
16636 
16631 


40CD 
40CE 
40CF 
40D 
40D1 

46D2 
40D3 
40D4 


40D5 
40D6 
40D7 
40D8 
4@D9 
40DA 
4@0DB 
46DC 
4@DD 
40DE 
4@DF 
4GE@0 
40E1 
4GE2 
4GE3 
4GE4 
4GE5 
4@E6 
4GE7 
4GE8 
4GE9 
4GEA 
40EB 
4GEC 
4@GED 
4GEE 
4GEF 
40FO 
40F1 
40F2 
40F3 
40F4 
40F5 
40F6 
40F7 


9B 
32 
30 
4d 
CD 
B2 
6B 
CD 


BB 
G2 
EB 
21 

FB 
EF 
AT 
ED 
52 

C8 
21 

7F 
FD 
A7 


52 
C8 
3A 
BA 
40 
FE 
G2 
28 
04 
FE 
23 
20 
G8 
3A 
B9 
4G 
2F 
3C 
32 
B9 


KEY 
TEST 


X-TEST 


LR REV 
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LD (T-ADDR),A 


CALL PLOT c.r. 


CALL KEYBOARD 


EX DE,HL 
LD HL,+EFFB 


AND A 

SBC HL,DE 
RET Z 

LD HL,+FD7F 
AND A 

SBC HL,DE 
RET Z 

LD A,(X) 

CP +02 

JR Z,LR-REV. 
CP +23 

JR NZ,Y-TEST 
LD A.(LR) 
CPL 


INCA 
LD (LR),A 


16632 
16633 
16634 
16635 
16636 
16637 
16638 
16639 
16640 
16641 
16642 
16643 
16644 
16645 
16646 
16647 
16648 
16649 
1665¢ 
16651 
16652 
16653 
16654 
16655 
16656 
16657 
16658 
16659 
16660 
16661 
16662 
16663 
16664 
16665 
16666 
16667 
16668 
16669 
16670 
16671 
16672 
16673 
16674 
16675 


40F8 
40F9 
40FA 
40FB 
40FC 
40FD 
40FE 
40FF 
4100 
4101 
4102 
4103 
4104 
4105 
4106 
4107 
4108 
4109 
41GA 
410B 
410C 
410D 
41GE 
410F 
4110 
4111 
4112 
4113 
4114 
4115 
4116 
4117 
4118 
4119 
411A 
411B 
411C 
411D 
411E 
411F 
4120 
4121 
4122 
4123 


Y-TEST 


UD REV 


UNPLOT 


X-UPDATE 


Y-UPDATE 


147 


LD A,(Y) 


CP +GA 

JR Z,UD-REV. 
CP +29 

JR NZ,UNPLOT 
LD A,(UD) 

CPL 


INC A 
LD (UD),A 


LD BC,(X) 


LD A,+A@ 


LD (T-ADDR),A 


CALL PLOT c.r. 


LD HL,+LR 


LD BC,+X 


LD A,(BC) 
SUB (HL) 
LD (BC),A 
DEC HL 
INC BC 
LD A,(BC) 


16676 4124 96 150 SUB (HL) 
16677 4125 62 2 LD (BC),A 
16678 4126 18 24 JR PLOT 
16679 4127 A@® 160 


The table shows that the routine uses 166 locations (16514-16579 
inclusively). 
The final program can now be entered. Enter: 


10 REM 1234567890 1234567890 123 

456789G 1234567896 1234567896 12345 

67896 1234567896 1234567896 1234567 166 locations 
890 1234567896 1234567896 123456789 reserved. 

@ 1234567890 1234567896 1234567896 1 


234567896 123456 

20 LET K=USR 16533 Location for START. 
36 POKE 16571, INT (RND*32+ 10) Set Y. 

4@ LET K=USR 16572 VALUES. 

5@ RUN 


Do not RUN this program until you have entered the machine code into 
line 18. SAVEing the program at this stage is advisable. 

The machine code loader used on page 131 was a rather simple 
loader program but for this longer machine code REM statement a better 
loader program is desirable. 


Enter the following lines: 

200 LET A=@ 

210 FOR B=16514 TO 16679 
220 INPUT C 

230 POKE B,C 

240 CLS 

258 LET A=A+C 

260 PRINT C,A 

270 NEXT B 

RUN 200 

This loader program gives a ‘checksum’ which can be compared to the 


values given below and hence gives a good indication if the input-data is 
correct. 


Enter: 
Checksum. 
62,128,6,19,215, 16,253,201 ,62,17,144, 1123 
71,205,245,8,62,128,215,20 1,205,40, 2503 
15,205,42, 16,205,130 ,64,6,16,197,14, 3407 
Q 205, 138,64, 193,197,14,18,205, 138, 4579 
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64,193,16,246 62,117,660 ,215,205, 136, 9881 


64,20 1,0,0,0,0,62,1,50,184,64,50,185 6742 
64,60 50 ,186,64,237,75,186,64,62,155, 7945 
56 ,48,64,205,178,11,205,187,2,235,33, 9163 
251,239, 167,237 ,82,206 33,127,253, 10752 
167,237 ,82,20G ,58,186,64,254,2,40,4, 12646 
254,35,32,8,58,185,64,47,60 50,185, 13024 
64,58,187,64,254, 10,40 ,4,254,41 32, 14032 
8,58, 184,64,47,60 50 ,184,64,237,75, 15063 
186,64,62,160 50 ,48,64,205, 178,11,33 16124 
185,64, 1,186,64,10,150,2,43,3,10,15¢, 16992 
2,24,160. 17178 


Delete lines 20@ - 270 and use SAVE “MOVING-BALL PROGRAM” 
before proceeding any further. 

Now enter RUN. The moving ball should appear, and go round and 
round the playing area being reflected off each wall that it hits. Re- 
member that the ‘R’ key is active and can be used to restart the ball. Also 
the ‘BREAK’ key is active. 

The reader might like to add lines to the program so as to create 
‘targets . 

e.g. 35 PLOT 20,26 

36 PLOT 22,22 
37 PLOT 25,19 
RUN 

The reader might also like to increase the size of the playing area by 

changing the appropriate values in the machine code program. 


7.5 AndSoOn... 


The machine code routine for the first example was only 17 bytes in 
length, whereas the two routines for the second example together used 
166 locations, and the 8K monitor program uses 8192! 

It is hoped that the reader can now appreciate just how a large 
machine code program is written. 

The two example programs in this chapter are really only an introduc- 
tion to the techniques of machine code programming but by building 
upon the suggested techniques it is possible to write very impressive 
programs. 

Good Luck. 
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Appendix i. 


The SAVE command routine. 


Hex. 
address code mnemonic comment 
G2F6 CDA8G@3 CALL G3A8 Check a name is given. 
2F9 38FI9 JR C,G2F4 Jump if no name - error 9. 
2FB €EB EX DE,HL 
2FC 11CB1i2 LD DE,+12CB 5 second timer. 
2FF CD43@0F CALL @GF43 Test for Break Key. 
302 302E JR NC,@332 Break pressed 
304 10FE DJNZ 0304 Delay loop. 
366 1B DEC DE Delay loop. 
307 7A LD A,D 
308 B3 OR E 
309 20F4 JR NZ,@2FF  Endof delay? 
308 CD1E@3 CALL @31E SAVE a byte of the name. 
3GE CB/7E BIT 7,(HL) Last byte of name? 
316 23 INC HL Next byte. 


311 28F8 JR Z,030B Name done? 
31321 09 4G LD HL,+4009 Startsendingsystem variables 


316 CD1E@3 CALL @31E Each byte. 

319 CDFC@1 CALL @1FC Update routine (see below). 
31C 18F8 JR 0316 Back for next byte. 
S1E 5E LD E,(HL) Byte into E. 

31F 37 SCF Set the ‘marker’. 
326 CB13 RL E Rotate ‘marker’ in. 
322 C8 RET Z 8 bits done? 

323 OF SBC AA A=@@ or A=FF. 
324 E605 AND +05 A=@6 or A=@5. 
326 C604 ADD +04 A=04 or A=@9. 
328 86 4F LD C,A Save in C. 


329 D3FF OUT (+FF),A To the cassette player. 
32B 6623 LD B,+23 Timing loop. 

32D =10FE DJNZ @32D 

32F CD43@0F CALL @GF43 Test for Break Key. 

332 3072 JR NC,@3A6 _— Error D if Break pressed. 
334 GQ@61E LD B,+1E Timing Loop. 

336 1@0FE DJNZ @0336 

338 OD DEC C Decrease counter. 

339 2@EE JR NZ,0329 __ Bit finished? 
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33B 
33C 
33E 
G1FC 
1FD 
1FE 
261 
202 
204 
205 
206 


207... 


A7 AND A 


16 FD DJNZ @33B 

18 E@ JR 0326 

23 INC HL 

EB EX DE,HL 
2A 1440 LD HL, (40 14) 
37 SCF 

ED 52 SBC HL,DE 
EB EX DE,HL 
D@ RET NC 

E1 POP HL 


The LOAD command routine. 


address code 


0340 
343 
345 
347 
34A 
34C 
34E 
350 
352 
354 
356 
357 
359 
35A 
35B 
35D 
35F 
360 
361 
364 
365 
366 


Hex. 
mnemonic 


CD A8@3 CALL @3A8 
CB 12 RL D 


CBGA ARC D 
CD4C@3 CALL 634C 
18FB JR 0347 
GE01 LD C,+01 
0600 LD B+00 
3E7F LD  A,+FF 
DBFE IN A(+FE) 
D3FF OUT (+FF),A 
1F RRA 

3049 JR  NC,@3A2 
17 RLA 

17 RLA 

3828 JR C0385 
19F1 DJNZ 6350 

F1 POP AF 

BA CP D 
D2E503 JP NC,@3E5 
62 LD HD 

6B LD LE 


CD 4C@3 CALL @34C 
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Timing loop. 


Next bit. 

Next byte. 

Exchange. 

All bytes up to E-Line. 


Test for end. 


( Return to SAVE next byte. 
( SAVEing finished so 

( continue with display. 

(or 

( Return to LOAD next byte. 
( LOADing finished so 

( continue with display. 


comment 
Check if name is given. 


Start listening to tape. 


Test Break Key. 
The ‘echo’ to the screen. 


Jump if Break pressed. 


Build-up a byte in C, if C is set. 


Re-initialise if needed. 
Transfer the ‘address of the 
program name’ to HL. 

Start listening. 


address Hex. code mnemonic 


369 
36B 
36C 
36E 
36F 
371 

372 
373 
375 
378 
37B 
37C 
37F 
380 
383 
385 
386 
388 
38A 
38B 
38D 
38E 


0396 
391 
393 
395 
396 
398 
39A 
39C 
39D 
39F 
SA1 


03A2 
3A3 
3A4 
G3A6 
3A7 


CB7A_ BIT 
79 LD 
20 63 JR 
BE CP 
20 D6 JR 
23 INC 
17 RLA 
30 F1 JR 
FD 3415 INC 
210940 LD 
50 LD 
CD 4C G3 CALL 
71 LD 
CD FC @1 CALL 
18 F6 JR 
D5 PUSH 
1E 94 LD 
O61A LD 
1D DEC 
DBFE IN 

17 RLA 
CB7B_ BIT 
7B LD 
38 F5 JR 
10 F5 DJNZ 
D1 POP 
20 64 JR 
FE 56 CP 
30 B2 JR 
3F CCF 
CB 11 RL 
30AD JR 
C9 RET 
7A LD 
A7 AND 
28 BB JR 
CF RST 
GC OC’ 


7,D 

A,C 
NZ,@371 
(HL) 
NZ,0347 
HL 


NC,@366 
(4015) 
HL,40G9 
D,B 
034C 
(HL),C 
QG1FC 
037B 
DE 
E,+94 
B,+1A 

E 
A,(+FE) 


i= 


A,E 
C,6388 
038A 

DE 
NZ,0@39C 
+56 
NC,@34E 


C 
NC,@34E 


A,D 

A 
2,0361 
6068 
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comment 


Match letters of ‘name’. 


Next letter of name. 


Start LOADing at 4009. 


Start listening to tape. 

Put byte in RAM. 

Update routine (see SAVE). 
Next byte. 


Timing loops. 


Current signal on tape. 


Build-up 
Byte in 


C register. 


Byte finished so return to 6369 
or @37F. 

Re-initialise if 

D is zero. 7 

otherwise error ‘D’. 

Error ‘D’ - Break key pressed. 


Keyboard Scanning Routine 
address Hex. code mnemonic comment 


@2BB 21FFFF LD HL,+FFFF Initialise HL. 
2BE @1FEFE LD BC,+FEFE The first port address. 


2C1 ED/78 IN A,(C) Read the first line. 
2C3 F6G@Q1 OR +61 Ignore Bit @. 

2C5 F6EG OR +€E@ Ignore Bits 5,6,7. 
2C7_ = =57 LD D,A Build-up 

2C8 2F CPL the 

2C9 FEG1 CP +01 Key Value 

2CB QF SBC A,A in 

2CC CBG OR B HL. 

2CD_ AS AND L 

2CE 6F LD LA 

2CF 7C LD A,H 

2D0 A2 AND D 

2D1 67 LD H,A 

2D2 CBG@@ RLC B 

2D4 ED78 IN A,(C) Read the other lines. 


2D6 38ED JR C,02C5 8 reads done? 
2D8  1F. RRA 


2D9 CB14 RL H Final key value in HL. 
2DB- 17 RLA 

2DC 17 RLA Test 

2DD 17 RLA line 6 

2DE 9F SBC AA UK/USA 

2DF E618 AND +18 standard 

2E1 C61F ADD +1F ZX-81. 

2E3 322840 LD (4628),A 

2E6 C9 RET Return. 


(see also appendix iv. ‘The Table of Key Values’.) page 


Keyboard decode routine 


address Hex. code mnemonic comment 
G@7BD 1600 LD D,+0@6 Enter with Key Value in BC. 
7BF CB28 SRA B 
7C1 = OF SBC AA Manipulate 
7C2  ~=F626 OR +26 the Key values. 
7C4 2E@5 LD L,+@5 to produce 
7C6 95 SUB L the A register 
7C7 85 ADD A,L holding 
7C8 = =37 SCF 1-78 (decimal). 
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709 
7CB 
7CD 
7CE 
7CF 
7D@6 
7D1 

7D3 
7D5 


7D8 
7D9 
7DA 
7DB 


CB 19 
38 FA 
GC 

CG 

48 

2D 

23 61 

26 F2 
217D0G@ 


5F 
19 
37 
C9 


RR 
JR 
INC 
RET 
LD 
DEC 
LD 
JR 
LD 


LD 

ADD 
SCF 
RET 


C 

C,67C7 

C 

NZ 

C,B 

L 

L,+@1 
NZ,+@7C7 
HL,+007D 


E,A 
HL,DE 
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Base address of character 
table. 

Transfer to E. 

Form the address in HL. 


Return with address of the 
character code in HL. 


Appendix ii. 


Tables of Z80 Machine Code Language Instructions. 


G@ G1 G2 03 04 @5 G6 G7 

NOP LD LD INCBC INCB DECB LD RLCA 
BC, (BC),A B,+dd 
+dddd 

10 11 12 13 14 15 16 17 

DJNZe LD LD INCDE INCD DECD LD RLA 
DE, (DE),A D,+dd 
+dddd 

20 21 22 23 24 25 26 27 

JR LD LD INCHL INCH DECH LD DAA 

NZ,e HL, (addr.) H,+dd 
+dddd HL 

30 31 32 33 34 ' 35 36 37 

JR LD LD INC SP INC DEC LD SCF 

NC,e_ SP, (addr.), (HL) (HL) (HL), 
+dddd A +dd 

40 41 42 43 44 45 46 47 


LD LD LD LD LD LD LD LD 
B,B B,C B,D B,E B,H B,L B,(HL) B,A 


50 51 52 53 54 55 36 57 
LD LD LD LD LD LD LD LD 
D,B D,C D,D D,E D,H D,L D,(HL) D,A 


6d 61 62 63 64 65 66 67 
LD LD LD LD LD LD LD LD 
H,B H,D H,C H,E H,H H,L H,(HL) H,A 


76 71 72 73 74 75 76 77 
LD LD LD LD LD LD HALT LD 
(HL),B (HL),C (HL),D (HL),E (HL),H (HL),L (HL),A 
86 81 B2 83 84 85 86 87 


ADD ADD ADD ADD ADD ADD ADD ADD 
A,B A,C A,D A,E A,H A,L A,(HL) A,A 


90 91 92 93 94 95 96 97 
SUBB SUBC SUBD SUBE SUBH SUBL SUB’ SUBA 


(HL) 
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AG Al A2 A3 A4 A5 A6 A7 
ANDB ANDC ANDD ANDE ANDH ANDL AND - ANDA 
(HL) 
Bo B1 B2 B3 B4 B5 B6 B7 
ORB ORC ORD ORE ORH ORL OR(HL)ORA 
Cd C1 C2 C3 C4 C5 C6 C7 
RET NZ POP BC JP JP CALL PUSH ADD RST 
NZ,addr.addr. NZ,addr.BC A,+dd @00@ 
Dd D1 D2 D3 D4 D5 D6 D7 
RET NC POP DE JP OUT CALL PUSH SUB RST 
NC, addr. (+dd) A NC,addr. DE +dd 0010 
E@ E1 E2 E3 E4 E5 E6 E7 
RET PO POP HL JP EX CALL PUSH AND RST 
PO,addr (HL),SP PO,addr HL +dd 0020 
FG F 1 F2 F3 F4 F5 F6 F7 
RETP POP AF JP DI CALL PUSH OR RST 
P, addr. P,addr. AF +dd 6030 
08 G9 GA 0B GC GD GE’ OF 
EX ADD LD DEC INCC DECC LD RRCA 
AF,A’F’ HL,BC A,(BC) BC C,+dd 
18 19 1A 1B 1C 1D 1E 1F 
JRe ADD LD DEC DEINCE DECE LD RRA 
HL,DE A,(DE) E,+dd 
(28 29 2A 2B 2C 2D 2E 2F 
JR ADD LD DECHLINCL DECL LD CPL 
Z,e HL,HL HL, i,+dd 
(addr.) 
38 39 3A 3B 3C 3D 3E 3F 
JR ADD LD DECSPINCA DECA LD CCF 
C,e HL,SP A,(addr.) A,+dd 
48 49 4A 4B 4C 4D 4E 4F 
LD LD LD LD LD LD LD LD 
C.B C,C C,D C,E C,H C,L C,(HL) C,A 
58 59 5A 5B 5C 5D 5E 5F 
LD LD LD LD LD LD LD LD 
E.B E,.C F.D E.E E,H EL E(HL) E,A 





68 69 6A 6B 6C 6D 6E 6F 
LD LD LD LD LD LD LD LD 
L.B L,C L,D LE L,H LL L(HL) LA 


78 79 7A 7B 7C 7D 7E 7F 
LD LD LD LD LD LD LD LD 
AB AC AD AE AH AL A(HL) AA 


88 89 8A 8B 8C 8D 8E 8F 
ADC ADC ADC ADC ADC ADC ADC ADC 
A,B A,C A,D A,E A,H A,L A,(HL) A,A 


98 99 9A 9B 9C 9D 9E OF 
SBC SBC SBC SBC SBC SBC SBC_ SBC 
A,B A,C A,D A,E A,H A,L A,(HL) A,A 


A8 AQ AA AB AC AD AE AF 

XORB XORC XORD XORE XORH XORL XOR  XORA 
(HL) 

BS BQ BA BB BC BD’ BE BF 

CPB CPC CPD CPE CPH CPL. CP(HL)CPA 


C8 C9 CA CB CC CD CE CF 
RETZ RET #£JP see CALL CALL ADC’ RST 
Z,addr. pages Z,addr. addr. A,+dd @0G08 
68, 70 


D8 D9 DA DB DC DD DE DF 
RETC EXX JP IN CALL see SBC RST 
C,addr. A,(+dd) C,addr. page A,+dd @018 
158 


E8 E9 EA EB EC ED EE EF 


RET PE JP JP EX CALL see XOR RST 
(HL) PE,addr.DE,HL PE,addrpage +dd 0028 

















158 
F8 F9 FA FB FC FD FE FF 
RETM LD JP El CALL see CP RST 
SP,HL M,adar. M,addr. page +dd 0038 
158 
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ED instructions 

















ED 40 
IN 


ED50 +=|ED6@ 
IN IN 
B,(C) D,(C) H,(C) 


ED A@ 
LDI 


ED B@ 
LDIR 





ED41 |ED51 |ED61 
OUT OUT OUT 
(C),B (C),D (C),H 


ED 42 ED 52 ED 62 ED 72 ED A2 ED B2 
SBC SBC SBC SBC INI INIR 
HL,BC HL,DE HL,HL HL,SP 


ED 43 ED 53 ED 63 ED 73 ED A3 ED B3 
LD LD LD LD OUTI OTIR 
(addr.),BC| (addr.),DE| (addr.),HL | (addr.),SP 


ED Al ED Bi 
CPI CPIR 






Smipmj2m 
Oimolmag 
Sapalj/dalOan 
ro ano as 





ED 47 ED 57 ED 67 
LDI,A LDA RRD 
ED 48 ED 58 ED 68 ED 78 ED A8 ED B8 


IN IN IN IN LDD LDDR 


ED49 |ED59 |ED69 |ED79 |EDA9 ~ EDBY 
OUT OUT OUT OUT CPD CPDR 
(C),C (C),E (C),L (C),A 


ED 4A ED 5A ED 6A ED7A |EDAA ED BA 
ADC ADC ADC ADC IND INDR 
HL,BC HL,DE HL,HL HL,SP 


| ED 4B ED 5B ED6B |ED7B |EDAB’ EDBB 
LD LD LD LD OUTD  OTRD 
BC, (addr.)| DE, (addr.)| HL,(addr.)| SP,(addr.) 

ED 4D 

RETI | 

ED 4F ED 5F 

LDR, |LDA,R 














ED 6F 
RLD | 
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The Indexing Instructions 


All the instructions using the IX register pair are prefixed by ‘DD’. All the 
instructions using the IY register pair are prefixed by ‘FD’. In the following 
simply read IY for IX and change DD to FD when dealing with the IY 
register pair. 


d 
d 
d 
d 
d 
d 
d 
d 
d 
d 
d 
d 
d 
d 
d 
d 
d 
d 
d 
d 
d 
d 


ADD IX,BC 
ADD IX,DE 


LD IX,+dddd_ 


LD (addr.),IX 
INC IX 

ADD IX,IX 
LD 1X,(addr.) 
DEC Ix 

INC (IX+d) 
DEC (IX+d) 


LD (IX+d),+dd 


ADD IX,SP 

LD B,(IX+d) 
LD C,(IX+d) 
LD D,(IX+d) 
LD E,(IX+d) 
LD H,(IX+d) 
LD L,(IX+d) 
LD (IX+d),B 
LD (IX+d),C 
LD (IX+d),D 
LD (IX+d),E 
LD (IX+d),H 
LD (IX+d),L 
LD (IX+d),A 
LD A,(IX+d) 
ADD A,(IX+d) 
ADC A,(IX+d) 
SUB (IX+d) 

SBC A,(IX+d) 
AND (iX+d) 

XOR (IX+d) 

OR (IX+d) 

CP (IX+d) 
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(IX+d) 
(IX+d) 
(IX+d) 
(IX+d) 
(IX+d) 
(IX+d) 
(IX+d) 
0,(IX+d) 
1,(IX+d) 
2,(IX+d) 
3,(IX+d) 
4,(IX+d) 
5,(IX+d) 
6,(IX+d) 
7,(IX+d) 
0,(IX+d) 
1,(IX+d) 
2,(IX+d) 
3,(IX+d) 
4,(IX+d) 
5,(IX+d) 
6,(1IX+d) 
7,(IX+d) 
0,(IX+d) 
1,(IX+d) 
2,(IX+d) 
3,(IX+d) 
4,(IX+d) 
5,(IX+d) 
6,(IX+d) 
7,(IX+d) 
IX 





SP, IX 
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Decimal-Hexadecimal Conversion Table 


DECIMAL 0-255 HEX. 00-FF LOW BYTE 
id al. ® al, » rik A » HEA 
0 00 64 40 128 80 -128 192 Co 
1 01 65 41 129 81 -127 193 C1 
2 02 66 42 130 82 -126 194 C2 
3 03 67 43 131 83 -125 195 C3 
4 04 68 44 132 84 -124 196 C4 
5 05 69 45 133 85 ~123 197 C5 
6 06 70 46 134 86 -122 198 C6 
Fé 07 71 47 135 87 -121 199 C7 
8 08 72 48 136 88 -120 200 C8 
9 09 73 49 137 89 -119 201 C9 
10 OA 74 4A 138 8A -118 202 CA 
11 0B 75 4B 139 8B -117 203 CB 
12 oC 76 4C 140 8C -116 204 CC 
13 oD 77 4D 141 8D -115 205 CD 
14 OE 78 4E 142 8E -114 206 CE 
15 OF 79 4F 143 8F “113 207 CF 
16 10 80 50 144 90 -112 208 DO 
17 11 81 51 145 91 -111 209 D1 
18 12 82 52 146 92 -110 210 D2 
19 13 83 53 147 93 -109 211 D3 
20 14 84 54 148 94 -108 212 D4 
21 15 85 55 149 95 -107 213 D5 
22 16 86 56 150 96 -106 214 D6 
23 17 87 57 151 97 -105 215 D7 
24 18 88 58 152 98 -104 216 D8 
25 19 89 59 153 99 -103 217 D9 
26 1A 90 5A 154 9A -102 218 DA 
27 1B 91 5B 155 9B -101 219 DB 
28 1C 92 5C 156 9C -100 220 DC 
29 1D 93 5D 157 9D - 99 221 DD 
30 1E 94 5E— 158 9E - 98 222 DE 
31 1F 95 5F 159 OF - 97 223 DF 
32 20 96 60 160 AO - 96 224 EO 
33 21 97 61 161 Al - 95 225 E1 
34 22 98 62 162 A2 - 94 226 E2 
35 23 99 63 163 A3 - 93 227 E3 
36 24 100 64 164 A4 - 92 228 E4 
37 25 101 65 165 A5 - 91 229 E5 
38 26 102 66 166 A6 - 90 230 E6 
39 27 103 67 167 A7 - 89 231 E7 
40 28 104 68 168 A8 - 88 232 E8 
41 29 105 69 169 AQ - 87 233 ES 
42 2A 106 6A 170 AA - 86 234 EA 
43 2B 107 6B 171 AB - 85 235 EB 
44 2C 108 6C 172 AC - 84 236 EC 
45 2D 109 6D 173 AD - 83 237 ED 
46 2E 110 6E 174 AE - 82 238 EE 
47 2F 111 6F 175 AF - 81 239 EF 
48 30 112 70 176 BO - 80 240 FO 
49 31 113 71 177 Bt - 79 241 F1 
50 32 114 72 178 82 - 78 242 F2 
51 33 115 73 179 B3 - 77 243 F3 
52 34 116 74 180 B4 - 76 244 F4 
53 35 117 75 181 B5 - 75 245 F5 
54 36 118 76 182 B6 - 74 246 F6 
55 37 119 77 183 B7 - 73 247 F7 
56 38 120 78 184 B8 - 72 248 F8 
57 39 121 79 185 B9 - 71 249 F9 
58 3A 122 7A 186 BA - 70 250 FA 
59 3B 123 7B 187 BB - 69 251 FB 
60 3C 124 7C 188 BC - 68 252 FC 
61 3D 125 7D 189 BD - 67 253 FD 
62 3E 126 7E 190 BE - 66 254 FE 
63 3F 127 7F 191 BF - 65 255 FF 
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Decimal-Hexadecimal Conversion Table (cont.) 


DECIMAL 0-65280 HEX. 00-FF, HIGH BYTE 
pecinst HEX. | DECIMAL HEX. | DECIMAL HEX. | DECIMAL HEX. 





Appendix iv. 
Table of ‘Key Values’ 


GRAPHICS 
RUBOUT 


O 
P 
A 
S 
D 
F 
G 
H 
J 

K 
L 

N 


e2fZ20<0OXN 
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